@owlmeans/viable-sdk 0.1.18-rc.8 → 0.1.18

package/build/types.d.ts

@@ -1,4 +1,5 @@
-import type { ConnectCapabilities, ConnectCapabilitiesView, ConnectHarness, ConnectJob, ConnectLlm, ConnectMarker, ConnectOp, ConnectOpResult, ConnectOpSubmission, ConnectPipelineState, ConnectProjectStatus, ConnectSessionView, ConnectStoryDeletion, ConnectStoryItem, ConnectStoryList, ConnectStoryMutation, ConnectTarget, ModelTask, ModelTaskResult, SlotCommandPayload } from '@owlmeans/viable-common';
+import type { PlanningFacade } from '@owlmeans/planning';
+import type { BlueprintCatalogue, ConnectAccessTokenList, ConnectAccessTokenRevoked, ConnectIntentPickup, ConnectPrivacyChoices, ConnectProfileSettingsView, ConnectProjectSettings, ConnectAgentLock, ConnectBrandingBackfill, ConnectCapabilities, ConnectConfigSaveBody, ConnectConfigScope, ConnectOrganizationBranding, ConnectOrganizationBrandingSave, ConnectProjectConfig, ConnectConvertCreateBody, ConnectConvertProceedBody, ConnectConvertStartBody, ConnectFileContent, ConnectFileMetaQuery, ConnectFileWritten, ConnectSlotView, ConnectGitCommit, ConnectGitCommitResult, ConnectGitRevertResult, ConnectGitState, ConnectGitStatus, ConnectGitSyncResult, ConnectGithubAuthorize, ConnectGithubBranchList, ConnectGithubBranchQuery, ConnectGithubConnection, ConnectGithubDisconnected, ConnectGithubLinkBody, ConnectGithubLinked, ConnectGithubPublishBody, ConnectGithubRepoList, ConnectGithubRepoQuery, ConnectProductionAuth, ConnectProductionDomain, ConnectProductionRedirects, ConnectProductionStatus, ConnectHarness, ConnectKitApplyBody, ConnectKitApplyResult, ConnectKitDescribe, ConnectLlm, ConnectMarker, ConnectOp, ConnectOpResult, ConnectOpSubmission, ConnectPipelineState, ConnectProjectBranding, ConnectProjectBrandingSave, ConnectProjectStatus, ConnectProjectSummary, ConnectSessionView, ConnectStoryStatus, ConnectTarget, ConversionStatusView, ConvertCheck, InquiryAnswerPayload, InquiryPayload, ModelTask, ModelTaskResult, SlotCommandPayload, IamAssignGrant, IamDefinitionUpdate, IamGrant, IamGrantsQuery, IamGrantsResponse, IamGroup, IamGroupCreate, IamGroupEdit, IamGroupsResponse, IamMember, IamMembersResponse, IamOrganization, IamOrganizationEdit, IamOrganizationsResponse, IamPermissionDefinition, IamPermissionsResponse, IamProjectMemberInvite, IamProjectMemberUpdate, IamProjectUserInvite, IamProjectUserUpdate, IamRevokeGrant, IamUser, IamUsersResponse, ConnectActivityQuery, ConnectFeedPage, ConnectFeedQuery, ConnectFileChanges, AgentSteerArgs, AgentSteerResult, AgentStopArgs, StoryBatchStartArgs, StoryBatchView } from '@owlmeans/viable-common';
 export interface SdkOptions {
     apiUrl: string;
     /** The access token. The connector authenticates with nothing else. */
@@ -21,15 +22,17 @@ export interface SdkOptions {
  * written against this, so a tool cannot accidentally work in only one of the two.
  */
 export interface ConnectorApi {
-    capabilities: () => Promise<ConnectCapabilitiesView>;
     openSession: (args: OpenSessionArgs) => Promise<ConnectSessionView>;
     closeSession: (sessionId: string) => Promise<void>;
-    heartbeat: (sessionId: string) => Promise<ConnectSessionView>;
     pullOps: (sessionId: string, waitSec: number) => Promise<ConnectOp[]>;
     submitOp: (sessionId: string, result: ConnectOpResult) => Promise<ConnectOpSubmission>;
     project: {
-        create: (prompt: string, target?: ConnectTarget) => Promise<ConnectJob>;
-        confirm: (projectId: string, edits: ProjectEdits) => Promise<ConnectJob>;
+        /**
+         * `sessionId`: the caller's UNATTACHED delegated session — its parent performs the checks the
+         * platform runs before the project card exists. Absent, the platform performs them.
+         */
+        create: (prompt: string, target?: ConnectTarget, sessionId?: string) => Promise<ConnectProjectStatus>;
+        confirm: (projectId: string, edits: ProjectEdits) => Promise<ConnectProjectStatus>;
         list: () => Promise<Array<{
             id: string;
             name: string;
@@ -40,24 +43,366 @@ export interface ConnectorApi {
             projectId?: string;
             slug?: string;
         }) => Promise<ConnectProjectStatus>;
-        reinit: (projectId: string) => Promise<ConnectJob>;
-        modify: (projectId: string, prompt: string) => Promise<ConnectJob>;
-        job: (projectId: string, jobId: string, waitSec?: number) => Promise<ConnectJob>;
+        reinit: (projectId: string) => Promise<ConnectProjectStatus>;
+        modify: (projectId: string, prompt: string) => Promise<ConnectProjectStatus>;
+        /**
+         * Rename the project: its record, specification, vision and what its code calls it. The web
+         * address stays. A new name starts an agent run, paid like an open-ended change.
+         */
+        rename: (projectId: string, name: string, description?: string) => Promise<ConnectProjectStatus>;
+        /**
+         * The planning kits the project can take: ready sets of card types and status flows, each
+         * for one kind of work-management product.
+         */
+        kitDescribe: (projectId: string) => Promise<ConnectKitDescribe>;
+        /**
+         * Write one kit's card types and flows into the project's common package (`types` keeps only
+         * those type keys). The platform rebuilds the preview itself; the answer says what was written.
+         */
+        kitApply: (projectId: string, body: ConnectKitApplyBody) => Promise<ConnectKitApplyResult>;
+        /**
+         * Delete the project and everything it owns — its preview and production workloads, its
+         * stories and documents, its configuration and its connector sessions. Cannot be undone; the
+         * answer names what was deleted.
+         */
+        destroy: (projectId: string) => Promise<ConnectProjectSummary>;
+        /**
+         * Release the project's agent lock by force — the recovery for a lock a crashed run left
+         * behind. A run still working is not stopped by it; the answer is the lock as it now stands.
+         */
+        unlock: (projectId: string) => Promise<ConnectAgentLock>;
+        /**
+         * Stop what the agent runs now — the web's Stop. A story run stops at its next step boundary and
+         * its changes since that run started are rolled back (the story returns to planned); an
+         * open-ended change stops once the model's current answer arrives and ends with a short summary,
+         * its edits kept; the `batch` scope cancels the batch first. Answers the lock, `stopping` set.
+         * Refused `AgentNotRunning` when nothing it reaches runs.
+         */
+        stop: (projectId: string, args: AgentStopArgs) => Promise<ConnectAgentLock>;
+        /**
+         * Send the open-ended change that runs now a message, read before the agent's next model call.
+         * Refused `AgentNotRunning` when no such run is open to messages.
+         */
+        steer: (projectId: string, args: AgentSteerArgs) => Promise<AgentSteerResult>;
+        /**
+         * A story batch — the web's Run all: several planned stories implemented one after another, in
+         * the order the platform chooses for building them.
+         */
+        batch: {
+            /**
+             * Start one over the stories named (card ids), or every planned story when `stories` is left
+             * out. Refused `StoryBatchActive` while another runs, `StoryBatchEmpty` when nothing planned is
+             * selected; each story's start is admitted like a person's Start.
+             */
+            start: (projectId: string, args: StoryBatchStartArgs) => Promise<StoryBatchView>;
+            /** The project's latest batch, or `null` when none ever ran. */
+            get: (projectId: string) => Promise<StoryBatchView | null>;
+            /** No further story starts; the story in progress is stopped through {@link stop}. */
+            cancel: (projectId: string) => Promise<StoryBatchView>;
+        };
+        /**
+         * What the project's agent did after a cursor — run starts and stops, pipeline steps, card,
+         * workload and conversion changes, git proposals, tool outcomes, and with `detail: thinking` the
+         * model's own words. Held up to `wait` seconds (at most 20) when nothing came yet; `gap` says
+         * entries after the cursor were dropped. The browser's project socket, polled.
+         */
+        activity: (projectId: string, query?: ConnectActivityQuery) => Promise<ConnectFeedPage>;
+        /**
+         * The project's inference override (`null` inherits the person's preference), what it resolves
+         * to and whether the plan allows the delegated mode.
+         */
+        llm: (projectId: string) => Promise<ConnectProjectSettings>;
+        /**
+         * Pin the project's inference mode, or `null` to inherit the person's preference again — a
+         * capability of the plan: refused `CapabilityRequired` when the plan has no delegated mode
+         * (clearing an override included, exactly as in the browser). It is the DEFAULT the
+         * URL-configured host and the browser use; a stdio connector already running keeps its `--llm`.
+         */
+        setLlm: (projectId: string, llmMode: ConnectLlm | null) => Promise<ConnectProjectSettings>;
+    };
+    /**
+     * The project settings a person edits on the project's control panel: the copyright line, the
+     * organization name, the Terms and Privacy links and the Google tag — and, read-only, where the
+     * platform credit stands (`credit`).
+     *
+     * Read and written as ONE record, because the platform validates them as one — a save merges the
+     * patch over what is stored, checks and moderates the merged record exactly as the web save does,
+     * and answers with it. `scope` names the production workload's own set; absent, the preview's.
+     */
+    projectBranding: (projectId: string, scope?: ConnectConfigScope) => Promise<ConnectProjectBranding>;
+    /**
+     * Change some of the project settings; the fields left out keep their stored values.
+     *
+     * The platform applies a change of the preview's set by a configuration push (which rebuilds it);
+     * production takes it at the next Publish. For a local target that push is a `Configure`
+     * operation, so the caller attaches its connector first.
+     */
+    saveProjectBranding: (projectId: string, patch: ConnectProjectBrandingSave, scope?: ConnectConfigScope) => Promise<ConnectProjectBranding>;
+    /**
+     * Hide (`true`) or show the platform credit — white label, a capability of the plan: refused
+     * `CapabilityRequired` when the plan does not include it. Answers the settings with the credit.
+     */
+    setPlatformCredit: (projectId: string, hidden: boolean, scope?: ConnectConfigScope) => Promise<ConnectProjectBranding>;
+    /** Replace the project's organization name and copyright with the organization's defaults. */
+    copyOrganizationBranding: (projectId: string, scope?: ConnectConfigScope) => Promise<ConnectProjectBranding>;
+    /**
+     * The project's configuration variables — what its generated application reads from its
+     * environment. A backend variable's value is a secret and never comes back: only whether it is set.
+     */
+    config: {
+        get: (projectId: string, scope?: ConnectConfigScope) => Promise<ConnectProjectConfig>;
+        /** Set the variables named (a patch); a save of the preview's set reconfigures and rebuilds it. */
+        save: (projectId: string, body: ConnectConfigSaveBody, scope?: ConnectConfigScope) => Promise<ConnectProjectConfig>;
+        /** Let the platform's agent read the sources again for the variables they declare. */
+        recollect: (projectId: string) => Promise<ConnectProjectConfig>;
+    };
+    /** The organization's own records. */
+    account: {
+        /** Installed blueprint and case catalogue; available before any project exists. */
+        blueprints: () => Promise<BlueprintCatalogue>;
+        /** The organization's branding defaults — what every new project starts with. */
+        branding: {
+            get: () => Promise<ConnectOrganizationBranding>;
+            save: (patch: ConnectOrganizationBrandingSave) => Promise<ConnectOrganizationBranding>;
+            /** Fill the projects' blank branding rows from the defaults; answers how many changed. */
+            backfill: () => Promise<ConnectBrandingBackfill>;
+        };
+        /**
+         * The person's own inference preference — the default of every project without an override.
+         * `set` is a capability of the plan (refused `CapabilityRequired` without the delegated mode).
+         */
+        llm: {
+            get: () => Promise<ConnectProfileSettingsView>;
+            set: (llmMode: ConnectLlm) => Promise<ConnectProfileSettingsView>;
+        };
+        /** The person's own access tokens: listed and revoked — never created through the connector. */
+        tokens: {
+            list: () => Promise<ConnectAccessTokenList>;
+            /** Revoke one of the person's own tokens (this connector's own included); idempotent. */
+            revoke: (tokenId: string) => Promise<ConnectAccessTokenRevoked>;
+        };
+        /** The person's own marketing consents: read, and withdrawn — never granted. */
+        privacy: {
+            status: () => Promise<ConnectPrivacyChoices>;
+            /** Write `granted: false` for each key; an unknown key refuses the whole call. */
+            withdraw: (keys: string[]) => Promise<ConnectPrivacyChoices>;
+        };
+        /** A prompt stashed on the public site, collected ONCE by its reference. */
+        intent: {
+            pickup: (ref: string) => Promise<ConnectIntentPickup>;
+        };
+        /** The organization's notices after a cursor, held up to `wait` seconds — the browser's toasts. */
+        notifications: (query?: ConnectFeedQuery) => Promise<ConnectFeedPage>;
     };
     story: {
-        list: (projectId: string, query?: StoryQuery) => Promise<ConnectStoryList>;
-        get: (projectId: string, storyId: string) => Promise<ConnectStoryItem>;
-        create: (projectId: string, story: string) => Promise<ConnectStoryMutation>;
-        update: (projectId: string, storyId: string, story: string) => Promise<ConnectStoryMutation>;
-        remove: (projectId: string, storyId: string) => Promise<ConnectStoryDeletion>;
-        develop: (projectId: string, storyId: string) => Promise<ConnectJob>;
+        status: (projectId: string, storyId: string) => Promise<ConnectStoryStatus>;
+    };
+    /**
+     * The platform's planning surface: projects, user stories and the documents behind them as
+     * cards, and every change to one as a transition.
+     *
+     * The story tools read and write through it. The scope it answers for is the CREDENTIAL's —
+     * the platform takes the organization, the profile and the channel from the token (over HTTP)
+     * or from the caller it authenticated (in process), never from anything a tool sends.
+     */
+    planning: PlanningFacade;
+    /**
+     * A cloud target's generated tree — the web editor's reads and writes. Paths are relative to the
+     * project root, as `list` prints them.
+     */
+    files: {
+        list: (projectId: string) => Promise<string[]>;
+        /** One file's content. */
+        get: (projectId: string, path: string) => Promise<ConnectFileContent>;
+        /**
+         * Replace one file's whole content (a new path creates it). The content is checked like the web
+         * editor's save and the preview is rebuilt; a build that failed is named on `buildWarning`, and
+         * the write stands either way. A file that decides how the project builds and starts is refused.
+         */
+        save: (projectId: string, path: string, content: string) => Promise<ConnectFileWritten>;
+        /** Delete one file, then rebuild the preview — `buildWarning` as for {@link save}. */
+        remove: (projectId: string, path: string) => Promise<ConnectFileWritten>;
+        /** The project's metadata documents of one kind: stories, specifications, or all of them. */
+        meta: (projectId: string, query: ConnectFileMetaQuery) => Promise<string[]>;
+        /**
+         * The preview tree's file changes after a cursor, held up to `wait` seconds; the read starts the
+         * preview's watcher when it is not running yet (`watching` says whether it runs).
+         */
+        changes: (projectId: string, query?: ConnectFeedQuery) => Promise<ConnectFileChanges>;
+    };
+    /**
+     * The project's PREVIEW workload — the web's sandbox controls; each answers the workload as it
+     * then stands. A cloud target only: a local project's process is the user's own.
+     */
+    sandbox: {
+        /** Start the preview (provisioning it first when it has none). */
+        run: (projectId: string) => Promise<ConnectSlotView>;
+        restart: (projectId: string) => Promise<ConnectSlotView>;
+        stop: (projectId: string) => Promise<ConnectSlotView>;
+        /**
+         * Reinstall the dependencies and rebuild — the repair for a preview that will not build. It runs
+         * on after the answer, holding the project's agent lock until it is done.
+         */
+        rebuild: (projectId: string) => Promise<ConnectSlotView>;
+    };
+    /** The organization's workloads, every project and kind (preview, production, local). */
+    slot: {
+        list: () => Promise<ConnectSlotView[]>;
+    };
+    /**
+     * A cloud target's git repository — the web Git dialog's own calls. Every write waits while an
+     * agent run holds the project (`git-busy`); a revert is a NEW commit, history is never rewritten.
+     */
+    git: {
+        /**
+         * The project's GitHub connection and its working tree — `git` is `null` while the preview is not
+         * ready (reading git there would start a stopped preview).
+         */
+        status: (projectId: string) => Promise<ConnectGitState>;
+        /** The latest commits, newest first. */
+        log: (projectId: string) => Promise<ConnectGitCommit[]>;
+        /** Commit every change of the working tree; `commit` is `null` when there was nothing to commit. */
+        commit: (projectId: string, message: string) => Promise<ConnectGitCommitResult>;
+        /** Throw away every uncommitted change; answers the clean tree. */
+        discard: (projectId: string) => Promise<ConnectGitStatus>;
+        /** Go back to one earlier commit's tree as a new commit, then rebuild the preview. */
+        revert: (projectId: string, hash: string) => Promise<ConnectGitRevertResult>;
+    };
+    /**
+     * The project's GitHub connection. `authorize` answers the address the PERSON opens: GitHub returns
+     * to the platform's web application, which completes the connection — nothing here completes it.
+     * The GitHub token is never answered.
+     */
+    github: {
+        authorize: (projectId: string) => Promise<ConnectGithubAuthorize>;
+        /** Publish to a new repository or an existing one; push and pull work from then on. */
+        publish: (projectId: string, body: ConnectGithubPublishBody) => Promise<ConnectGithubConnection>;
+        push: (projectId: string) => Promise<ConnectGitSyncResult>;
+        pull: (projectId: string) => Promise<ConnectGitSyncResult>;
+        /** Forget the connection — the repository on GitHub is left as it is. */
+        disconnect: (projectId: string) => Promise<ConnectGithubDisconnected>;
+        /** One page of the person's repositories. */
+        repos: (projectId: string, query?: ConnectGithubRepoQuery) => Promise<ConnectGithubRepoList>;
+        /** One page of one repository's branches. */
+        branches: (projectId: string, query: ConnectGithubBranchQuery) => Promise<ConnectGithubBranchList>;
+        /** Record which repository an imported project came FROM — nothing is pushed or published. */
+        link: (projectId: string, body: ConnectGithubLinkBody) => Promise<ConnectGithubLinked>;
+    };
+    /**
+     * A cloud target's PRODUCTION workload — the web Publish dialog's own calls; never the preview.
+     * A publish holds a published-sites unit of the plan (`LimitExhausted` when it has no room), a
+     * custom domain and the standalone sign-in are paid capabilities (`CapabilityRequired`). The
+     * sign-in's client secret is never answered: `auth` says whether one is set.
+     */
+    production: {
+        /** The production workload (`null` before the first publish) and its domain. */
+        status: (projectId: string) => Promise<ConnectProductionStatus>;
+        /** Build and deploy the current sources as the published site; it goes live after the answer. */
+        publish: (projectId: string) => Promise<ConnectProductionStatus>;
+        /** Restart the site — a stopped one is redeployed, and takes a published-sites unit again. */
+        restart: (projectId: string) => Promise<ConnectProductionStatus>;
+        /** Stop the site and give its published-sites unit back; its data is kept. */
+        stop: (projectId: string) => Promise<ConnectProductionStatus>;
+        domain: {
+            /** Attach a custom domain; answers the DNS records the owner creates. */
+            attach: (projectId: string, domain: string) => Promise<ConnectProductionDomain | null>;
+            /** Ask the provider again whether the records are in place. */
+            verify: (projectId: string) => Promise<ConnectProductionDomain | null>;
+            /** Detach the custom domain; the generated address keeps serving. */
+            detach: (projectId: string) => Promise<ConnectProductionDomain | null>;
+        };
+        /** The standalone sign-in configuration — never its secret. */
+        auth: (projectId: string) => Promise<ConnectProductionAuth>;
+        /** Replace the standalone redirect addresses; applied on the next publish. */
+        setRedirects: (projectId: string, redirects: string[]) => Promise<ConnectProductionRedirects>;
+    };
+    /**
+     * The generated app's sign-in — the owner console's own calls, per project and per app: `scope`
+     * picks the preview's client (absent) or production's. Platform records, so a local target's app is
+     * managed here too. An IAM refusal the owner can act on (the staff group's members, bundles or
+     * existence, a managed definition, the last owner) is `IamRefused` (`iam-refused:<marker>`); a
+     * backend that keeps a listing in a console of its own answers it empty with `external: true`.
+     * Organizations travel by slug, groups by key.
+     */
+    iam: {
+        /** Every end user of every app the organization owns — read-only; a person is managed per project. */
+        organizationUsers: () => Promise<IamUsersResponse>;
+        /** The app's permission definitions and its tenancy flags. */
+        permissions: (projectId: string, scope?: ConnectConfigScope) => Promise<IamPermissionsResponse>;
+        /** A definition's default class or organization binding; an omitted setting is kept. */
+        setDefault: (projectId: string, body: IamDefinitionUpdate) => Promise<IamPermissionDefinition>;
+        grants: {
+            /**
+             * Every grant, one person's (`profileId`) or one group's (`group` with its `entitySlug`) — what
+             * is held, plus the inherited grants a subject's own restriction withholds (`restricted: true`).
+             */
+            list: (projectId: string, query?: IamGrantsQuery) => Promise<IamGrantsResponse>;
+            /** Grant to exactly one subject — a person or a group. */
+            assign: (projectId: string, body: IamAssignGrant) => Promise<IamGrant>;
+            /** A whole-permission revoke restricts the subject; `mode: inherit` takes its own value back. */
+            revoke: (projectId: string, body: IamRevokeGrant) => Promise<void>;
+        };
+        users: {
+            list: (projectId: string, scope?: ConnectConfigScope) => Promise<IamUsersResponse>;
+            /** Find-or-create, by e-mail. */
+            invite: (projectId: string, body: IamProjectUserInvite) => Promise<IamUser>;
+            update: (projectId: string, profileId: string, body: IamProjectUserUpdate) => Promise<IamUser>;
+            /** Remove from this app only — the account and its other apps stay. */
+            remove: (projectId: string, profileId: string, scope?: ConnectConfigScope) => Promise<void>;
+        };
+        organizations: {
+            list: (projectId: string, scope?: ConnectConfigScope) => Promise<IamOrganizationsResponse>;
+            /** Retitle; the slug stays. */
+            update: (projectId: string, entitySlug: string, body: IamOrganizationEdit) => Promise<IamOrganization>;
+            members: (projectId: string, entitySlug: string, scope?: ConnectConfigScope) => Promise<IamMembersResponse>;
+            addMember: (projectId: string, entitySlug: string, body: IamProjectMemberInvite) => Promise<IamMember>;
+            updateMember: (projectId: string, entitySlug: string, profileId: string, body: IamProjectMemberUpdate) => Promise<IamMember>;
+            removeMember: (projectId: string, entitySlug: string, profileId: string, scope?: ConnectConfigScope) => Promise<void>;
+        };
+        groups: {
+            list: (projectId: string, entitySlug: string, scope?: ConnectConfigScope) => Promise<IamGroupsResponse>;
+            /** Find-or-create by key. */
+            ensure: (projectId: string, entitySlug: string, body: IamGroupCreate) => Promise<IamGroup>;
+            /** Title and the WHOLE bundle list (it replaces the group's); an omitted field is kept. */
+            update: (projectId: string, entitySlug: string, group: string, body: IamGroupEdit) => Promise<IamGroup>;
+            remove: (projectId: string, entitySlug: string, group: string, scope?: ConnectConfigScope) => Promise<void>;
+            members: (projectId: string, entitySlug: string, group: string, scope?: ConnectConfigScope) => Promise<IamMembersResponse>;
+            addMembers: (projectId: string, entitySlug: string, group: string, profileIds: string[], scope?: ConnectConfigScope) => Promise<void>;
+            removeMembers: (projectId: string, entitySlug: string, group: string, profileIds: string[], scope?: ConnectConfigScope) => Promise<void>;
+        };
     };
     pipeline: {
         state: (projectId: string, runId: string) => Promise<ConnectPipelineState>;
         resume: (projectId: string, runId: string, args?: {
             from?: string;
             force?: boolean;
-        }) => Promise<ConnectJob>;
+        }) => Promise<ConnectPipelineState>;
+    };
+    /**
+     * Bringing an application the platform did not generate onto its rails.
+     *
+     * State-changing verbs return the conversion's current domain status. Long-running work remains
+     * server-side and is observed through `status`; broker records are never part of this API.
+     */
+    convert: {
+        create: (args: ConnectConvertCreateBody) => Promise<ConversionStatusView>;
+        check: (projectId: string) => Promise<ConvertCheck>;
+        /** `body.confirm`: a person agreed to what the start uses (`ConnectConfirmationRequired` otherwise). */
+        start: (projectId: string, body?: ConnectConvertStartBody) => Promise<ConversionStatusView>;
+        proceed: (projectId: string, body: ConnectConvertProceedBody) => Promise<ConversionStatusView>;
+        status: (projectId: string) => Promise<ConversionStatusView>;
+        purge: (projectId: string) => Promise<ConversionStatusView>;
+    };
+    /**
+     * Answering a question by its own id.
+     *
+     * The fallback path, and never the first one: while a connector holds the question it answers
+     * the OPERATION it arrived on, which is what the platform is actually waiting for. This is for a
+     * run that parked while nobody was attached — its operation has timed out, and the question is
+     * then reachable only through the project it belongs to.
+     */
+    inquiry: {
+        answer: (projectId: string, inquiryId: string, answer: InquiryAnswerPayload) => Promise<unknown>;
     };
 }
 export interface OpenSessionArgs {
@@ -74,15 +419,9 @@ export interface ProjectEdits {
     description?: string;
     specification?: string;
     vision?: string;
+    designSystem?: string;
     target?: ConnectTarget;
 }
-export interface StoryQuery {
-    page?: number;
-    size?: number;
-    status?: string;
-    area?: string;
-    q?: string;
-}
 /** What a connector executes locally. Absent for a cloud target — the platform's pod does it. */
 export interface LocalExecutor {
     execute: (payload: SlotCommandPayload) => Promise<unknown>;
@@ -98,8 +437,16 @@ export interface LocalExecutor {
 export interface SessionRuntime {
     session: ConnectSessionView;
     stats: SessionStats;
-    /** The next model task for the parent agent, or null if none arrives within the wait. */
-    nextTask: (waitMs: number) => Promise<ModelTask | null>;
+    /**
+     * The next model task for the parent agent, or null if none arrives within the wait or the
+     * signal aborts. Among queued tasks, the one that expires first.
+     */
+    nextTask: (waitMs: number, signal?: AbortSignal) => Promise<ModelTask | null>;
+    /**
+     * Whether a model task is queued, waiting up to `waitMs` for one; takes nothing. What a tool
+     * blocked on a platform call races that call against.
+     */
+    taskAvailable: (waitMs: number, signal?: AbortSignal) => Promise<boolean>;
     /** A task already handed out and not yet answered — what an answer is checked against. */
     taskById: (taskId: string) => ModelTask | null;
     /** Handed to the parent and still unanswered, oldest first. */
@@ -108,6 +455,22 @@ export interface SessionRuntime {
     submitTask: (result: ModelTaskResult) => Promise<void>;
     /** How many tasks are waiting right now. */
     pendingTasks: () => number;
+    /**
+     * The next question for the person the parent agent is working for, or null within the wait.
+     *
+     * A separate queue from the tasks and drained by a separate tool, because the two are answered
+     * by different parties on entirely different timescales — and a question that reached a
+     * subagent would be answered by a model, which is the one outcome asking exists to avoid.
+     */
+    nextQuestion: (waitMs: number) => Promise<InquiryPayload | null>;
+    /** A question already put to the parent and not yet answered — what an answer is checked against. */
+    questionById: (inquiryId: string) => InquiryPayload | null;
+    /** Put to the parent and still unanswered, oldest first. */
+    outstandingQuestions: () => InquiryPayload[];
+    /** Hand back what the person decided. */
+    answerQuestion: (answer: InquiryAnswerPayload) => Promise<void>;
+    /** How many questions are waiting right now. */
+    pendingQuestions: () => number;
     close: () => Promise<void>;
 }
 export interface SessionStats {
@@ -115,9 +478,11 @@ export interface SessionStats {
     opsFailed: number;
     tasksDelivered: number;
     tasksSubmitted: number;
+    questionsDelivered: number;
+    questionsAnswered: number;
     lastActivityAt: number;
-    /** How the connector is currently receiving operations. */
-    transport: 'socket' | 'pull' | 'none';
+    /** How the connector is currently receiving operations: by long poll, or not at all once closed. */
+    transport: 'pull' | 'none';
 }
 export interface SdkMarker extends ConnectMarker {
 }

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/build/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The `/mcp` URL a person, a doc or a verification tool should use: the value the merged
+ * configuration names (environment over `~/.owlmeans`, already resolved by the caller), else the
+ * production default. An empty value counts as unset, and a trailing slash is dropped — a
+ * canonical resource URI (RFC 8707) has one spelling.
+ */
+export declare const resolveMcpUrl: (values: Record<string, string | undefined>) => string;
+//# sourceMappingURL=utils.d.ts.map

package/build/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,WAAY,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAG,MAI1E,CAAA"}

package/build/utils.js

@@ -0,0 +1,12 @@
+import { DEFAULT_MCP_URL, ENV_MCP_URL } from './consts.js';
+/**
+ * The `/mcp` URL a person, a doc or a verification tool should use: the value the merged
+ * configuration names (environment over `~/.owlmeans`, already resolved by the caller), else the
+ * production default. An empty value counts as unset, and a trailing slash is dropped — a
+ * canonical resource URI (RFC 8707) has one spelling.
+ */
+export const resolveMcpUrl = (values) => {
+    const named = values[ENV_MCP_URL];
+    return (named != null && named !== '' ? named : DEFAULT_MCP_URL).replace(/\/+$/, '');
+};
+//# sourceMappingURL=utils.js.map

package/build/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAA0C,EAAU,EAAE;IAClF,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;IAEjC,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACtF,CAAC,CAAA"}