@owlmeans/viable-common 0.0.11 → 0.0.13

package/build/agent/presentation.js

@@ -0,0 +1,303 @@
+/**
+ * A compact, runtime-free description of how an agent message should be presented.
+ *
+ * The server emits this with thinking events and the browser refines it as streaming output
+ * becomes parseable. Keeping the vocabulary here prevents the two runtimes from drifting into
+ * their own guesses about the same model response.
+ */
+export var AgentMessageCategory;
+(function (AgentMessageCategory) {
+    AgentMessageCategory["Code"] = "code";
+    AgentMessageCategory["Diff"] = "diff";
+    AgentMessageCategory["Structured"] = "structured";
+    AgentMessageCategory["Markdown"] = "markdown";
+    AgentMessageCategory["Plain"] = "plain";
+})(AgentMessageCategory || (AgentMessageCategory = {}));
+export var AgentCodeLanguage;
+(function (AgentCodeLanguage) {
+    AgentCodeLanguage["ReactTsx"] = "react-tsx";
+    AgentCodeLanguage["Css"] = "css";
+    AgentCodeLanguage["TypeScript"] = "typescript";
+    AgentCodeLanguage["Json"] = "json";
+    AgentCodeLanguage["Other"] = "other";
+})(AgentCodeLanguage || (AgentCodeLanguage = {}));
+/** A semantic shape that the manager can render as a purpose-built card. */
+export var AgentStructuredKind;
+(function (AgentStructuredKind) {
+    AgentStructuredKind["ToolCalls"] = "tool-calls";
+    AgentStructuredKind["ArtifactSelection"] = "artifact-selection";
+    AgentStructuredKind["EntitySelection"] = "entity-selection";
+    AgentStructuredKind["StoryPlan"] = "story-plan";
+    AgentStructuredKind["ScreenPlan"] = "screen-plan";
+    AgentStructuredKind["ComponentPlan"] = "component-plan";
+    AgentStructuredKind["TransitionPlan"] = "transition-plan";
+    AgentStructuredKind["EntrypointSelection"] = "entrypoint-selection";
+    AgentStructuredKind["AccessPolicy"] = "access-policy";
+    AgentStructuredKind["ScaffoldPlan"] = "scaffold-plan";
+    AgentStructuredKind["RuntimeDecision"] = "runtime-decision";
+    AgentStructuredKind["CandidateRanking"] = "candidate-ranking";
+    AgentStructuredKind["Decision"] = "decision";
+    AgentStructuredKind["GenericRecord"] = "generic-record";
+    AgentStructuredKind["GenericList"] = "generic-list";
+    AgentStructuredKind["GenericValue"] = "generic-value";
+})(AgentStructuredKind || (AgentStructuredKind = {}));
+export var AgentMarkdownKind;
+(function (AgentMarkdownKind) {
+    AgentMarkdownKind["Specification"] = "specification";
+    AgentMarkdownKind["DesignDocument"] = "design-document";
+    AgentMarkdownKind["Documentation"] = "documentation";
+})(AgentMarkdownKind || (AgentMarkdownKind = {}));
+/** The family of specialist that produced an output, not an authorization role. */
+export var AgentMessageRole;
+(function (AgentMessageRole) {
+    AgentMessageRole["Technical"] = "technical";
+    AgentMessageRole["Analytical"] = "analytical";
+    AgentMessageRole["Product"] = "product";
+    AgentMessageRole["Ux"] = "ux";
+    AgentMessageRole["VisualDesign"] = "visual-design";
+    AgentMessageRole["Architect"] = "architect";
+    AgentMessageRole["Developer"] = "developer";
+    AgentMessageRole["Repair"] = "repair";
+    AgentMessageRole["Orchestrator"] = "orchestrator";
+})(AgentMessageRole || (AgentMessageRole = {}));
+const documentActions = {
+    'write-specification': AgentMarkdownKind.Specification,
+    'summarize-specification': AgentMarkdownKind.Specification,
+    'write-design-concept': AgentMarkdownKind.DesignDocument,
+    'describe-ui-component': AgentMarkdownKind.DesignDocument,
+    'describe-ui-screen': AgentMarkdownKind.DesignDocument,
+    'describe-ui-layout': AgentMarkdownKind.DesignDocument,
+};
+const codeActions = new Set(['code', 'update-code', 'update-code-full']);
+/**
+ * The model's schema makes the final output self-describing; while it streams, the helper action
+ * gives the client the same semantic cue before a complete JSON value exists.
+ */
+const structuredActions = {
+    'choose-files-for-fix': AgentStructuredKind.ArtifactSelection,
+    'list-files-to-fix': AgentStructuredKind.ArtifactSelection,
+    'extract-user-stories-from-spec': AgentStructuredKind.StoryPlan,
+    'derive-connecting-stories': AgentStructuredKind.StoryPlan,
+    'derive-area-scaffold-stories': AgentStructuredKind.StoryPlan,
+    'describe-ux-story-transitions': AgentStructuredKind.TransitionPlan,
+    'find-entrypoint-for-screen': AgentStructuredKind.EntrypointSelection,
+    'describe-api-access': AgentStructuredKind.AccessPolicy,
+    'describe-screen-access': AgentStructuredKind.AccessPolicy,
+    'plan-scaffold': AgentStructuredKind.ScaffoldPlan,
+    'runtime-gate': AgentStructuredKind.RuntimeDecision,
+    'detect-story-with-home-screen': AgentStructuredKind.CandidateRanking,
+};
+const asRecord = (value) => value != null && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : undefined;
+const actionOf = (input) => input.action?.toLowerCase() ?? '';
+const sourceOf = (input) => `${input.agent ?? ''} ${input.helper ?? ''}`.toLowerCase();
+const contentOf = (input) => input.text?.trim() ?? '';
+/**
+ * Source extraction is an internal context-reduction pass. Its terminal tool call contains only
+ * line ranges, which are useful to the coder but add no useful information to a person's journal.
+ */
+export const isAgentMessageHidden = (input) => actionOf(input) === 'source-extract';
+/** Maps the attribution that reached the event boundary to the visual specialist family. */
+export const agentMessageRoleOf = (input) => {
+    const source = sourceOf(input);
+    const action = actionOf(input);
+    if (action === 'arbitrary-modification' || source.includes('orchestrator'))
+        return AgentMessageRole.Orchestrator;
+    if (source.includes('fix'))
+        return AgentMessageRole.Repair;
+    if (source.includes('coder') || source.includes('developer') || codeActions.has(action))
+        return AgentMessageRole.Developer;
+    if (source.includes('visual') || source.includes('ui-helper'))
+        return AgentMessageRole.VisualDesign;
+    if (source.includes('ux-'))
+        return AgentMessageRole.Ux;
+    if (source.includes('business') || source.includes('ba-') || source.includes('analysis') || source.includes('analyst'))
+        return AgentMessageRole.Analytical;
+    if (source.includes('product') || source.includes('naming'))
+        return AgentMessageRole.Product;
+    if (source.includes('architect') || source.includes('arch') || source.includes('layout-helper') ||
+        source.includes('api-helper') || source.includes('access-helper') || source.includes('datalayer-helper') ||
+        source.includes('domain') || source.includes('nav-helper') || source.includes('ui-com-helper') ||
+        source.includes('ui-state-helper'))
+        return AgentMessageRole.Architect;
+    return AgentMessageRole.Technical;
+};
+/** Pulls a schema argument out of LangChain's serialised tool-call shape. */
+export const agentToolCallArguments = (value) => {
+    if (!Array.isArray(value) || value.length !== 1)
+        return value;
+    const call = asRecord(value[0]);
+    return call?.args ?? value;
+};
+const structuredKindOf = (value) => {
+    if (value == null)
+        return undefined;
+    const toolArgs = agentToolCallArguments(value);
+    const object = asRecord(toolArgs);
+    if (object == null) {
+        if (Array.isArray(toolArgs))
+            return AgentStructuredKind.GenericList;
+        return undefined;
+    }
+    // Checked ahead of the single-array shapes below: a scaffold plan carries its own `stories`
+    // array (so the StoryPlan check would otherwise swallow it), and a runtime decision straight
+    // from the MODEL never carries `actor`/`worker` — those are added only once the decision is
+    // persisted onto a StoryDesign — so requiring them here missed every live model call.
+    if ('identity' in object && 'guestHome' in object && 'areas' in object && 'stories' in object) {
+        return AgentStructuredKind.ScaffoldPlan;
+    }
+    if (Array.isArray(object.jobs) && Array.isArray(object.agents) && 'kv' in object) {
+        return AgentStructuredKind.RuntimeDecision;
+    }
+    if (Array.isArray(object.files))
+        return AgentStructuredKind.ArtifactSelection;
+    if (Array.isArray(object.entities))
+        return AgentStructuredKind.EntitySelection;
+    if (Array.isArray(object.stories))
+        return AgentStructuredKind.StoryPlan;
+    if (Array.isArray(object.screens))
+        return AgentStructuredKind.ScreenPlan;
+    if (Array.isArray(object.components))
+        return AgentStructuredKind.ComponentPlan;
+    if (Array.isArray(object.transitions))
+        return AgentStructuredKind.TransitionPlan;
+    if (Array.isArray(object.entries))
+        return AgentStructuredKind.EntrypointSelection;
+    if (Array.isArray(object.candidates))
+        return AgentStructuredKind.CandidateRanking;
+    if (Object.values(object).some(value => {
+        const entry = asRecord(value);
+        return entry != null && Array.isArray(entry.permissions) && 'level' in entry;
+    }))
+        return AgentStructuredKind.AccessPolicy;
+    return AgentStructuredKind.GenericRecord;
+};
+const decisionAction = (action) => action.startsWith('should-') || action.startsWith('is-') || action.includes('blueprint-case') || action.includes('choose-case');
+const fileExtensionLanguage = (path) => {
+    const name = path.toLowerCase().split('?')[0];
+    if (/\.(tsx|jsx)$/.test(name))
+        return AgentCodeLanguage.ReactTsx;
+    if (/\.css$/.test(name))
+        return AgentCodeLanguage.Css;
+    if (/\.(ts|mts|cts|js|mjs|cjs)$/.test(name))
+        return AgentCodeLanguage.TypeScript;
+    if (/\.json$/.test(name))
+        return AgentCodeLanguage.Json;
+    return AgentCodeLanguage.Other;
+};
+/** Finds the language of a unified diff from its destination (or source) file path. */
+export const agentDiffLanguageOf = (text) => {
+    const match = text.match(/^\+\+\+\s+(?:b\/)?(.+)$/m) ?? text.match(/^---\s+(?:a\/)?(.+)$/m);
+    return match == null ? AgentCodeLanguage.Other : fileExtensionLanguage(match[1]);
+};
+const fencedLanguageOf = (text) => {
+    const match = text.match(/^```([\w+-]+)/m);
+    const language = match?.[1]?.toLowerCase();
+    if (language == null)
+        return undefined;
+    if (['tsx', 'jsx', 'react'].includes(language))
+        return AgentCodeLanguage.ReactTsx;
+    if (language === 'css')
+        return AgentCodeLanguage.Css;
+    if (['ts', 'typescript', 'js', 'javascript'].includes(language))
+        return AgentCodeLanguage.TypeScript;
+    if (language === 'json')
+        return AgentCodeLanguage.Json;
+    return AgentCodeLanguage.Other;
+};
+/** Conservative code detection; prose with one identifier remains plain text. */
+export const agentCodeLanguageOf = (text) => {
+    const content = text.trim().replace(/^```[\w+-]*\n?|\n?```$/g, '');
+    const fenced = fencedLanguageOf(text);
+    if (fenced != null)
+        return fenced;
+    if (content === '')
+        return AgentCodeLanguage.Other;
+    try {
+        JSON.parse(content);
+        if (/^[{[]/.test(content))
+            return AgentCodeLanguage.Json;
+    }
+    catch {
+        // The remaining heuristics deliberately require source-like syntax.
+    }
+    if (/<[A-Za-z][\w.:-]*(?:\s[^>]*)?\/>|<[A-Za-z][\w.:-]*(?:\s[^>]*)?>/.test(content) &&
+        /\b(import|export|const|function|return)\b/.test(content))
+        return AgentCodeLanguage.ReactTsx;
+    if (/(^|\n)\s*(?:[.#][\w-]+|[a-z][\w-]*(?:\[[^\]]+\])?)\s*\{[^}]*:[^}]*\}/.test(content)) {
+        return AgentCodeLanguage.Css;
+    }
+    if (/\b(import|export|interface|type|const|let|function|class)\b/.test(content) &&
+        /[;{}]|=>/.test(content))
+        return AgentCodeLanguage.TypeScript;
+    return AgentCodeLanguage.Other;
+};
+export const isUnifiedDiff = (text) => /^---\s+.+\n\+\+\+\s+.+/m.test(text) || (/^@@\s+[-+]/m.test(text) && /^(?:\+|-)[^+-]/m.test(text));
+const markdownKindOf = (text) => {
+    if (/^#{1,6}\s+/m.test(text) || /^>\s+/m.test(text) || /^\|.+\|\s*$/m.test(text)) {
+        return AgentMarkdownKind.Documentation;
+    }
+    const listItems = text.match(/^\s*(?:[-*+]\s+|\d+[.)]\s+)/gm)?.length ?? 0;
+    return listItems >= 2 ? AgentMarkdownKind.Documentation : undefined;
+};
+/**
+ * Classifies known model output by source AND shape. The `value` comes from a caller's JSON
+ * parser; this runtime-free package intentionally never repairs or parses streamed JSON itself.
+ */
+/**
+ * Actions run by an unconstrained tool-calling loop (the coding agent, the repair/architect/
+ * lookup sub-agents, source extraction) rather than a single pinned-schema call. Their tool calls
+ * are file/shell operations, not model-schema output, so they always render as ToolCalls even
+ * when a call's arguments happen to shape-match a schema kind — `read_sources({ files })` looks
+ * exactly like an ArtifactSelection.
+ */
+const agentLoopActions = new Set([
+    'coding-agent-ask', 'arbitrary-modification', 'fix-agent', 'architect', 'declaration-lookup',
+    'source-extract',
+]);
+const isGenericStructure = (kind) => kind == null || kind === AgentStructuredKind.GenericRecord || kind === AgentStructuredKind.GenericList ||
+    kind === AgentStructuredKind.GenericValue;
+export const classifyAgentMessage = (input) => {
+    const role = agentMessageRoleOf(input);
+    const action = actionOf(input);
+    const text = contentOf(input);
+    const structure = structuredKindOf(input.value);
+    if (input.outputType === 'tool_calls') {
+        // A single pinned-schema call resolves to its own card; everything else — several calls in
+        // one turn, an unconstrained agent-loop action, or a shape too generic to be informative —
+        // is a tool call, not a schema result.
+        const isMultiCall = Array.isArray(input.value) && input.value.length > 1;
+        const isToolCalls = isMultiCall || agentLoopActions.has(action) || isGenericStructure(structure);
+        return {
+            category: AgentMessageCategory.Structured,
+            structure: isToolCalls ? AgentStructuredKind.ToolCalls : structure,
+            role,
+        };
+    }
+    if (structure != null)
+        return { category: AgentMessageCategory.Structured, structure, role };
+    const actionStructure = structuredActions[action];
+    if (actionStructure != null)
+        return { category: AgentMessageCategory.Structured, structure: actionStructure, role };
+    if (decisionAction(action))
+        return { category: AgentMessageCategory.Structured, structure: AgentStructuredKind.Decision, role };
+    if (isUnifiedDiff(text) || action === 'update-code') {
+        return { category: AgentMessageCategory.Diff, language: agentDiffLanguageOf(text), role };
+    }
+    if (codeActions.has(action) || fencedLanguageOf(text) != null || agentCodeLanguageOf(text) !== AgentCodeLanguage.Other) {
+        return { category: AgentMessageCategory.Code, language: agentCodeLanguageOf(text), role };
+    }
+    const document = documentActions[action] ?? markdownKindOf(text);
+    if (document != null)
+        return { category: AgentMessageCategory.Markdown, document, role };
+    if (input.value != null) {
+        return {
+            category: AgentMessageCategory.Structured,
+            structure: Array.isArray(input.value) ? AgentStructuredKind.GenericList : AgentStructuredKind.GenericValue,
+            role,
+        };
+    }
+    return { category: AgentMessageCategory.Plain, role };
+};
+//# sourceMappingURL=presentation.js.map

package/build/agent/presentation.js.map

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

package/build/blueprint/case.js

@@ -45,8 +45,8 @@ export var GameKind;
 /** What every AI case installs. The langchain peers are declared here, at ONE range. */
 const AI_DEPS = {
     [SubProject.Backend]: {
-        '@owlmeans/llm': '^0.1.18-rc.13',
-        '@owlmeans/agent': '^0.1.18-rc.16',
+        '@owlmeans/llm': '^0.1.18-rc.22',
+        '@owlmeans/agent': '^0.1.18-rc.25',
         '@langchain/core': '^1.2.9',
         '@langchain/anthropic': '^1.5.8',
         '@langchain/openai': '^1.5.10',
@@ -189,7 +189,7 @@ in advance.
                 deps: {
                     [SubProject.Backend]: {
                         ...AI_DEPS[SubProject.Backend],
-                        '@owlmeans/agent-skills': '^0.1.18-rc.12',
+                        '@owlmeans/agent-skills': '^0.1.18-rc.21',
                     },
                 },
                 libraries: AI_LIBRARIES,

package/build/connect/consts.d.ts

@@ -62,8 +62,20 @@ export declare enum ConnectExecutor {
     Files = "files",
     Shell = "shell",
     Git = "git",
-    /** The parent agent will answer model tasks. Present exactly when `llm` is `Local`. */
-    Model = "model"
+    /**
+     * The parent agent PERFORMS the model calls of a run: each one arrives as a `ModelTask`, is run
+     * in a clean subagent and submitted back. Present exactly when `llm` is `Local`.
+     */
+    Model = "model",
+    /**
+     * A PERSON can be asked a question and their answer brought back.
+     *
+     * Advertised always, and by every connector: a parent agent has a human in front of it by
+     * definition, which is the whole reason the platform can ask one anything at all. It is not a
+     * narrower `Model` — a model task is inference the platform pays for either way, an inquiry is
+     * a decision only a person can make, and a run that cannot ask assumes instead.
+     */
+    Human = "human"
 }
 /** What one operation asks a connector to do. */
 export declare enum ConnectOpKind {
@@ -72,7 +84,15 @@ export declare enum ConnectOpKind {
     /** Run one model call and submit its answer. */
     ModelTask = "model-task",
     /** Write the target's configuration (its `.env` files) and report what services are reachable. */
-    Configure = "configure"
+    Configure = "configure",
+    /**
+     * Put one question to the person the connector is working for, and bring back their answer.
+     *
+     * An operation like any other — queued to the project, redelivered to whichever session is
+     * attached, answered against its own op id — because the alternative was a second channel with
+     * its own delivery, expiry and reattachment rules for the one payload that already had them.
+     */
+    Inquiry = "inquiry"
 }
 /** How a connector is receiving operations. */
 export declare enum ConnectTransport {
@@ -152,7 +172,19 @@ export declare enum ConnectJobKind {
     ProjectReinit = "project-reinit",
     StoryDevelop = "story-develop",
     FreeFlight = "free-flight",
-    PipelineResume = "pipeline-resume"
+    PipelineResume = "pipeline-resume",
+    /**
+     * The four stages of a conversion, plus the purge.
+     *
+     * One kind per stage rather than one for the whole conversion: each stage is its own platform
+     * pipeline run, ends at a decision the user makes, and is looked up by the pipeline alias its
+     * kind names. A single `convert` kind would match whichever run row happened to be newest.
+     */
+    ConvertIntake = "convert-intake",
+    ConvertAnalysis = "convert-analysis",
+    ConvertExtraction = "convert-extraction",
+    ConvertImplementation = "convert-implementation",
+    ConvertPurge = "convert-purge"
 }
 export declare enum ConnectJobStatus {
     Queued = "queued",
@@ -169,8 +201,46 @@ export declare enum ConnectJobBlock {
     /** Slot commands are queued and no connector is attached. */
     LocalOp = "local-op",
     /** The local target has no database configured and the run needs one. */
-    Env = "env"
+    Env = "env",
+    /** A question is waiting for a person and nobody has answered it. */
+    Question = "question"
 }
+/**
+ * The shapes a question can take on the wire.
+ *
+ * Mirrors `InquiryKind` in `@owlmeans/llm-common` value for value, and is deliberately a SEPARATE
+ * name rather than an import: the connect module is the wire contract and owns its own vocabulary
+ * — the same reason `ModelTask` mirrors `DelegatedTask` — which also keeps `manager-api`, which
+ * does not depend on the model runtime, free of `@owlmeans/llm-common`. Values are byte-identical,
+ * so the platform's mapper is a widening rather than a translation table, and a test pins that.
+ */
+export declare enum ConnectInquiryKind {
+    /** Pick one of the offered options, or several when `multiple` is set. */
+    Choice = "choice",
+    /** Free text. */
+    Text = "text",
+    /** Yes or no. */
+    Confirm = "confirm"
+}
+/**
+ * How long the platform waits for a person to answer one question.
+ *
+ * The same forty-five minutes a model task gets, and for the same reason: the bound exists so a
+ * parent that has gone away eventually fails the step rather than holding a project lock forever,
+ * not to pace somebody who is thinking.
+ */
+export declare const CONNECT_INQUIRY_TIMEOUT_MS = 2700000;
+/** Options one choice question may offer. Beyond this it is a text question with a hint. */
+export declare const CONNECT_INQUIRY_MAX_OPTIONS = 12;
+/**
+ * The ceiling on an answer's text.
+ *
+ * ONE ceiling for the whole stack: the twin is `DEFAULT_INQUIRY_ANSWER_CHARS` in
+ * `@owlmeans/llm-common`, and the two must stay equal. Two ceilings means the layer with the
+ * larger one truncates silently at the smaller, and the caller records an assumption about an
+ * answer the person actually gave.
+ */
+export declare const CONNECT_INQUIRY_MAX_TEXT = 2000;
 /**
  * How long a session survives without a sign of life.
  *
@@ -237,6 +307,7 @@ export declare const CONNECT_EVENT_SESSION = "connect:session";
 export declare const CONNECT_OP_PUBSUB = "connect-op-pubsub";
 export declare const CONNECT_RESULT_PUBSUB = "connect-result-pubsub";
 export declare const CONNECT_OP_STORE = "connect-op-store";
+export declare const CONNECT_RESULT_STORE = "connect-result-store";
 export declare const CONNECT_SESSION_PUBSUB = "connect-session-pubsub";
 /** The backend resource alias for session records. */
 export declare const RES_CONNECT_SESSION = "connect-session";
@@ -273,8 +344,22 @@ export declare const connect: Readonly<{
         modify: "viable:manager-api:connect:project:modify";
         settings: "viable:manager-api:connect:project:settings";
         llm: "viable:manager-api:connect:project:llm";
+        /** The per-project converter inference mode. Separate from `llm`: it is not a paid capability. */
+        converterLlm: "viable:manager-api:connect:project:converter-llm";
         job: "viable:manager-api:connect:project:job";
     }>;
+    convert: Readonly<{
+        create: "viable:manager-api:connect:convert:create";
+        check: "viable:manager-api:connect:convert:check";
+        start: "viable:manager-api:connect:convert:start";
+        proceed: "viable:manager-api:connect:convert:proceed";
+        cancel: "viable:manager-api:connect:convert:cancel";
+        status: "viable:manager-api:connect:convert:status";
+        purge: "viable:manager-api:connect:convert:purge";
+    }>;
+    inquiry: Readonly<{
+        answer: "viable:manager-api:connect:inquiry:answer";
+    }>;
     story: Readonly<{
         list: "viable:manager-api:connect:story:list";
         get: "viable:manager-api:connect:story:get";
@@ -283,6 +368,9 @@ export declare const connect: Readonly<{
         delete: "viable:manager-api:connect:story:delete";
         develop: "viable:manager-api:connect:story:develop";
     }>;
+    files: Readonly<{
+        list: "viable:manager-api:connect:files:list";
+    }>;
     pipeline: Readonly<{
         state: "viable:manager-api:connect:pipeline:state";
         resume: "viable:manager-api:connect:pipeline:resume";

package/build/connect/consts.d.ts.map

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

package/build/connect/consts.js

@@ -67,8 +67,20 @@ export var ConnectExecutor;
     ConnectExecutor["Files"] = "files";
     ConnectExecutor["Shell"] = "shell";
     ConnectExecutor["Git"] = "git";
-    /** The parent agent will answer model tasks. Present exactly when `llm` is `Local`. */
+    /**
+     * The parent agent PERFORMS the model calls of a run: each one arrives as a `ModelTask`, is run
+     * in a clean subagent and submitted back. Present exactly when `llm` is `Local`.
+     */
     ConnectExecutor["Model"] = "model";
+    /**
+     * A PERSON can be asked a question and their answer brought back.
+     *
+     * Advertised always, and by every connector: a parent agent has a human in front of it by
+     * definition, which is the whole reason the platform can ask one anything at all. It is not a
+     * narrower `Model` — a model task is inference the platform pays for either way, an inquiry is
+     * a decision only a person can make, and a run that cannot ask assumes instead.
+     */
+    ConnectExecutor["Human"] = "human";
 })(ConnectExecutor || (ConnectExecutor = {}));
 /** What one operation asks a connector to do. */
 export var ConnectOpKind;
@@ -79,6 +91,14 @@ export var ConnectOpKind;
     ConnectOpKind["ModelTask"] = "model-task";
     /** Write the target's configuration (its `.env` files) and report what services are reachable. */
     ConnectOpKind["Configure"] = "configure";
+    /**
+     * Put one question to the person the connector is working for, and bring back their answer.
+     *
+     * An operation like any other — queued to the project, redelivered to whichever session is
+     * attached, answered against its own op id — because the alternative was a second channel with
+     * its own delivery, expiry and reattachment rules for the one payload that already had them.
+     */
+    ConnectOpKind["Inquiry"] = "inquiry";
 })(ConnectOpKind || (ConnectOpKind = {}));
 /** How a connector is receiving operations. */
 export var ConnectTransport;
@@ -197,6 +217,18 @@ export var ConnectJobKind;
     ConnectJobKind["StoryDevelop"] = "story-develop";
     ConnectJobKind["FreeFlight"] = "free-flight";
     ConnectJobKind["PipelineResume"] = "pipeline-resume";
+    /**
+     * The four stages of a conversion, plus the purge.
+     *
+     * One kind per stage rather than one for the whole conversion: each stage is its own platform
+     * pipeline run, ends at a decision the user makes, and is looked up by the pipeline alias its
+     * kind names. A single `convert` kind would match whichever run row happened to be newest.
+     */
+    ConnectJobKind["ConvertIntake"] = "convert-intake";
+    ConnectJobKind["ConvertAnalysis"] = "convert-analysis";
+    ConnectJobKind["ConvertExtraction"] = "convert-extraction";
+    ConnectJobKind["ConvertImplementation"] = "convert-implementation";
+    ConnectJobKind["ConvertPurge"] = "convert-purge";
 })(ConnectJobKind || (ConnectJobKind = {}));
 export var ConnectJobStatus;
 (function (ConnectJobStatus) {
@@ -216,7 +248,46 @@ export var ConnectJobBlock;
     ConnectJobBlock["LocalOp"] = "local-op";
     /** The local target has no database configured and the run needs one. */
     ConnectJobBlock["Env"] = "env";
+    /** A question is waiting for a person and nobody has answered it. */
+    ConnectJobBlock["Question"] = "question";
 })(ConnectJobBlock || (ConnectJobBlock = {}));
+/**
+ * The shapes a question can take on the wire.
+ *
+ * Mirrors `InquiryKind` in `@owlmeans/llm-common` value for value, and is deliberately a SEPARATE
+ * name rather than an import: the connect module is the wire contract and owns its own vocabulary
+ * — the same reason `ModelTask` mirrors `DelegatedTask` — which also keeps `manager-api`, which
+ * does not depend on the model runtime, free of `@owlmeans/llm-common`. Values are byte-identical,
+ * so the platform's mapper is a widening rather than a translation table, and a test pins that.
+ */
+export var ConnectInquiryKind;
+(function (ConnectInquiryKind) {
+    /** Pick one of the offered options, or several when `multiple` is set. */
+    ConnectInquiryKind["Choice"] = "choice";
+    /** Free text. */
+    ConnectInquiryKind["Text"] = "text";
+    /** Yes or no. */
+    ConnectInquiryKind["Confirm"] = "confirm";
+})(ConnectInquiryKind || (ConnectInquiryKind = {}));
+/**
+ * How long the platform waits for a person to answer one question.
+ *
+ * The same forty-five minutes a model task gets, and for the same reason: the bound exists so a
+ * parent that has gone away eventually fails the step rather than holding a project lock forever,
+ * not to pace somebody who is thinking.
+ */
+export const CONNECT_INQUIRY_TIMEOUT_MS = 2_700_000;
+/** Options one choice question may offer. Beyond this it is a text question with a hint. */
+export const CONNECT_INQUIRY_MAX_OPTIONS = 12;
+/**
+ * The ceiling on an answer's text.
+ *
+ * ONE ceiling for the whole stack: the twin is `DEFAULT_INQUIRY_ANSWER_CHARS` in
+ * `@owlmeans/llm-common`, and the two must stay equal. Two ceilings means the layer with the
+ * larger one truncates silently at the smaller, and the caller records an assumption about an
+ * answer the person actually gave.
+ */
+export const CONNECT_INQUIRY_MAX_TEXT = 2_000;
 /**
  * How long a session survives without a sign of life.
  *
@@ -283,6 +354,7 @@ export const CONNECT_EVENT_SESSION = 'connect:session';
 export const CONNECT_OP_PUBSUB = 'connect-op-pubsub';
 export const CONNECT_RESULT_PUBSUB = 'connect-result-pubsub';
 export const CONNECT_OP_STORE = 'connect-op-store';
+export const CONNECT_RESULT_STORE = 'connect-result-store';
 export const CONNECT_SESSION_PUBSUB = 'connect-session-pubsub';
 /** The backend resource alias for session records. */
 export const RES_CONNECT_SESSION = 'connect-session';
@@ -319,8 +391,22 @@ export const connect = Object.freeze({
         modify: 'viable:manager-api:connect:project:modify',
         settings: 'viable:manager-api:connect:project:settings',
         llm: 'viable:manager-api:connect:project:llm',
+        /** The per-project converter inference mode. Separate from `llm`: it is not a paid capability. */
+        converterLlm: 'viable:manager-api:connect:project:converter-llm',
         job: 'viable:manager-api:connect:project:job',
     }),
+    convert: Object.freeze({
+        create: 'viable:manager-api:connect:convert:create',
+        check: 'viable:manager-api:connect:convert:check',
+        start: 'viable:manager-api:connect:convert:start',
+        proceed: 'viable:manager-api:connect:convert:proceed',
+        cancel: 'viable:manager-api:connect:convert:cancel',
+        status: 'viable:manager-api:connect:convert:status',
+        purge: 'viable:manager-api:connect:convert:purge',
+    }),
+    inquiry: Object.freeze({
+        answer: 'viable:manager-api:connect:inquiry:answer',
+    }),
     story: Object.freeze({
         list: 'viable:manager-api:connect:story:list',
         get: 'viable:manager-api:connect:story:get',
@@ -329,6 +415,9 @@ export const connect = Object.freeze({
         delete: 'viable:manager-api:connect:story:delete',
         develop: 'viable:manager-api:connect:story:develop',
     }),
+    files: Object.freeze({
+        list: 'viable:manager-api:connect:files:list',
+    }),
     pipeline: Object.freeze({
         state: 'viable:manager-api:connect:pipeline:state',
         resume: 'viable:manager-api:connect:pipeline:resume',