plan

type DeletePlanArgs struct {
	Name              string `json:"name" jsonschema:"The name of the plan to delete."`
	LastKnownRevision *int   `` /* 183-byte string literal not displayed */
}

type ExportPlanToFileArgs struct {
	Name string `json:"name" jsonschema:"The name of the plan to export."`
	Path string `` /* 185-byte string literal not displayed */
}

type ExportResult struct {
	Name         string `json:"name"`
	Path         string `json:"path"`
	Title        string `json:"title,omitempty"`
	Status       string `json:"status,omitempty"`
	Revision     int    `json:"revision"`
	BytesWritten int    `json:"bytesWritten"`
}

type FilesystemStorage struct {
	// contains filtered or unexported fields
}

type GetPlanStatusArgs struct {
	Name string `json:"name" jsonschema:"The name of the plan whose status to read."`
}

type ListResult struct {
	Plans    []Summary `json:"plans"`
	Warnings []string  `json:"warnings,omitempty"`
}

type Option func(*ToolSet)

type Plan struct {
	Name    string `json:"name"`
	Title   string `json:"title,omitempty"`
	Content string `json:"content"`
	// Author is a free-form label identifying who last wrote the plan
	// (typically the agent name). It helps collaborators see who made the
	// most recent change.
	Author string `json:"author,omitempty"`
	// Status is a free-form lifecycle label (e.g. "idle", "in-progress",
	// "blocked", "done"). There is no fixed vocabulary: agents and users define
	// their own in the system prompt.
	Status string `json:"status,omitempty"`
	// Revision is the plan's monotonically increasing version number, bumped on
	// every write. Callers capture it on a read and pass it back as
	// last_known_revision to detect concurrent modifications (optimistic
	// locking).
	Revision  int    `json:"revision"`
	UpdatedAt string `json:"updatedAt"`
}

type ReadPlanArgs struct {
	Name string `json:"name" jsonschema:"The name of the plan to read."`
}

type SetPlanStatusArgs struct {
	Name              string `json:"name" jsonschema:"The name of the plan whose status to set."`
	Status            string `` /* 131-byte string literal not displayed */
	LastKnownRevision *int   `` /* 182-byte string literal not displayed */
}

type StatusView struct {
	Name     string `json:"name"`
	Status   string `json:"status"`
	Revision int    `json:"revision"`
}

type Storage interface {
	// Get returns the named plan. The bool is false with a nil error when no
	// such plan exists, so callers can tell a missing plan apart from a real
	// read failure (returned as a non-nil error).
	Get(ctx context.Context, name string) (Plan, bool, error)
	// Upsert creates or updates a plan as described by req: nil fields are
	// preserved from the previous revision, the optimistic-lock check and the
	// must-exist guard are honoured atomically with the write, the revision is
	// bumped and UpdatedAt stamped. It returns a *VersionConflictError on a
	// revision mismatch and ErrPlanNotFound when req.MustExist is set but the
	// plan is absent.
	Upsert(ctx context.Context, req UpsertRequest) (Plan, error)
	// List returns a summary of every stored plan. Warnings carries entries
	// that could not be read, so a caller can tell "no plans" apart from "some
	// plans failed to load".
	List(ctx context.Context) (plans []Summary, warnings []string, err error)
	// Delete removes the named plan. The bool is false with a nil error when
	// there was no such plan to delete. When expectedRevision is non-nil the
	// delete is rejected with a *VersionConflictError unless it matches the
	// plan's current revision.
	Delete(ctx context.Context, name string, expectedRevision *int) (deleted bool, err error)
}

type Summary struct {
	Name      string `json:"name"`
	Title     string `json:"title,omitempty"`
	Author    string `json:"author,omitempty"`
	Status    string `json:"status,omitempty"`
	Revision  int    `json:"revision"`
	UpdatedAt string `json:"updatedAt"`
}

type ToolSet struct {
	// contains filtered or unexported fields
}

type UpdatePlanFromFileArgs struct {
	Name              string `json:"name" jsonschema:"The plan name. Lowercase letters, digits, '-' and '_' only."`
	Path              string `` /* 144-byte string literal not displayed */
	Title             string `json:"title,omitempty" jsonschema:"Optional human-readable title. Preserved from the previous revision when omitted."`
	Author            string `` /* 139-byte string literal not displayed */
	Status            string `json:"status,omitempty" jsonschema:"Optional free-form lifecycle status. Preserved from the previous revision when omitted."`
	LastKnownRevision *int   `` /* 182-byte string literal not displayed */
}

type UpsertRequest struct {
	Name             string
	Content          *string
	Title            *string
	Author           *string
	Status           *string
	ExpectedRevision *int
	MustExist        bool
}

type VersionConflictError struct {
	Name     string
	Expected int
	Current  int
}

type WritePlanArgs struct {
	Name              string `json:"name" jsonschema:"The plan name. Lowercase letters, digits, '-' and '_' only (e.g. 'release', 'db-migration')."`
	Content           string `json:"content" jsonschema:"The full plan content (markdown). Replaces the existing plan."`
	Title             string `json:"title,omitempty" jsonschema:"Optional human-readable title. Preserved from the previous revision when omitted."`
	Author            string `` /* 166-byte string literal not displayed */
	Status            string `` /* 164-byte string literal not displayed */
	LastKnownRevision *int   `` /* 219-byte string literal not displayed */
}