@owlmeans/viable-sdk 0.1.18-rc.1

package/build/task/inquiry.d.ts

@@ -0,0 +1,53 @@
+import type { ConnectHarness, InquiryAnswerPayload, InquiryPayload } from '@owlmeans/viable-common';
+/**
+ * The two values a confirmed and a refused question answer with.
+ *
+ * Mirrors `CONFIRM_YES` / `CONFIRM_NO` in `@owlmeans/llm-common` — the package that reads the
+ * answer — value for value, and is deliberately a copy rather than an import: this package is
+ * installed by developers to drive their own machine and must not carry the model runtime, which
+ * is the same reason {@link ConnectInquiryKind} mirrors `InquiryKind`. The two must stay equal, or
+ * a person's "yes" reaches the asker as a value it has never heard of.
+ */
+export declare const CONFIRM_YES = "yes";
+export declare const CONFIRM_NO = "no";
+export interface QuestionEnvelopeOptions {
+    /** Which parent agent is reading this. Recorded rather than branched on — see below. */
+    harness: ConnectHarness;
+}
+/**
+ * What `next_question` hands the parent agent.
+ *
+ * Text, and in the same order a model task's envelope uses: how to handle it, what to call
+ * afterwards, then the material — so a model that stops reading early has still read the
+ * instruction. The question id appears at the top and in the follow-up call because it is the only
+ * thing that routes an answer back.
+ *
+ * The one thing this envelope says that the task envelope inverts: **do not isolate it**. A model
+ * task is handed to a clean subagent precisely so no context leaks into it; a question is handed to
+ * a PERSON, and a subagent has none. So there is no harness-specific isolation wording here at
+ * all — the harness is carried only because the caller has it and a future difference would belong
+ * beside the rest.
+ *
+ * The declined line is present on every question, whatever its kind. A parent whose user is not
+ * available has to have a way to say so: without one it either waits out a 45-minute timeout or
+ * invents an answer, and the second is worse.
+ */
+export declare const renderQuestionEnvelope: (inquiry: InquiryPayload, _opts: QuestionEnvelopeOptions) => string;
+export interface ParsedAnswer {
+    answer?: InquiryAnswerPayload;
+    /** Present when what came back is not something this question can accept. Quoted back verbatim. */
+    problem?: string;
+}
+/**
+ * Check what the parent sent against the question that asked for it, before the platform sees it.
+ *
+ * The same rule the model-task parser follows, for the same reason: a refusal caught here is a
+ * sentence the parent can act on immediately, with the person still in front of it, while one the
+ * platform catches costs a round trip on a question a human already answered. So a mismatch comes
+ * back as a `problem` rather than a throw, and every problem names what WOULD be accepted.
+ *
+ * `declined` short-circuits everything. It is a real answer — somebody saw the question and chose
+ * not to decide — and reading anything else beside it would let a parent both decline and answer.
+ */
+export declare const parseAnswer: (inquiry: InquiryPayload, raw: Record<string, unknown>) => ParsedAnswer;
+//# sourceMappingURL=inquiry.d.ts.map

package/build/task/inquiry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inquiry.d.ts","sourceRoot":"","sources":["../../src/task/inquiry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAEnG;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAA;AAChC,eAAO,MAAM,UAAU,OAAO,CAAA;AAiE9B,MAAM,WAAW,uBAAuB;IACtC,wFAAwF;IACxF,OAAO,EAAE,cAAc,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB,YACxB,cAAc,SAAS,uBAAuB,KACtD,MAiDF,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B,mGAAmG;IACnG,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAeD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,YACb,cAAc,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACpD,YAiFF,CAAA"}

package/build/task/inquiry.js

@@ -0,0 +1,232 @@
+import { ConnectInquiryKind, CONNECT_INQUIRY_MAX_TEXT } from '@owlmeans/viable-common';
+/**
+ * The two values a confirmed and a refused question answer with.
+ *
+ * Mirrors `CONFIRM_YES` / `CONFIRM_NO` in `@owlmeans/llm-common` — the package that reads the
+ * answer — value for value, and is deliberately a copy rather than an import: this package is
+ * installed by developers to drive their own machine and must not carry the model runtime, which
+ * is the same reason {@link ConnectInquiryKind} mirrors `InquiryKind`. The two must stay equal, or
+ * a person's "yes" reaches the asker as a value it has never heard of.
+ */
+export const CONFIRM_YES = 'yes';
+export const CONFIRM_NO = 'no';
+/** What a parent may send for a confirm question, beyond the two values themselves. */
+const CONFIRM_WORDS = {
+    yes: CONFIRM_YES,
+    y: CONFIRM_YES,
+    true: CONFIRM_YES,
+    ok: CONFIRM_YES,
+    no: CONFIRM_NO,
+    n: CONFIRM_NO,
+    false: CONFIRM_NO,
+};
+/** Whether this question actually carries values a parent can pick from. */
+const hasOptions = (inquiry) => inquiry.options != null && inquiry.options.length > 0;
+/**
+ * The call lines a question of THIS kind is answered with.
+ *
+ * Every line printed here has to be a call the parent can actually make. The value placeholder
+ * used to be one line for every kind — `"<one of the values below>"` — and a `Confirm` carries no
+ * options, so it pointed at nothing: the parent had to already know the two words, which is the
+ * one thing an envelope exists to make unnecessary. A confirm therefore prints its two values in
+ * the call itself, and a `Text` question — which has no values either — leads with the field it is
+ * actually answered in.
+ *
+ * A `Choice` that arrived with NO options is the same defect in the remaining kind, and it is a
+ * shape that reaches here: `InquiryPayload.options` is optional and only the free-flight
+ * `ask_user` tool enforces the "between 2 and max" rule, so nothing on the wire does. It is
+ * therefore read as a text question in both directions — the call prints `text`, and
+ * {@link parseAnswer} takes text back — rather than pointing "below" at an OPTIONS section the
+ * envelope will not print.
+ *
+ * The two confirm words are the same pair {@link parseAnswer} reads back, and it reads them in any
+ * case a parent sends, so a printed value is always an accepted one.
+ */
+const answerCalls = (inquiry) => {
+    const call = (body) => `answer_question { "questionId": "${inquiry.id}", ${body} }`;
+    const lines = [];
+    if (inquiry.kind === ConnectInquiryKind.Confirm) {
+        lines.push(`  ${call(`"answer": "${CONFIRM_YES}"`)}                        (they agreed)`, `  or ${call(`"answer": "${CONFIRM_NO}"`)}                      (they did not)`);
+    }
+    else if (inquiry.kind === ConnectInquiryKind.Text || !hasOptions(inquiry)) {
+        lines.push(`  ${call('"text": "<what they said>"')}         (their own words)`);
+    }
+    else {
+        lines.push(`  ${call('"answer": "<one of the values below>"')}`);
+        if (inquiry.multiple === true) {
+            lines.push(`  or ${call('"answer": ["<value>", "<value>"]')}   (several)`);
+        }
+        if (inquiry.allowText === true) {
+            lines.push(`  or ${call('"text": "<what they said>"')}         (their own words)`);
+        }
+    }
+    // Present on every question whatever its kind: a parent whose user is not available has to have
+    // a way to say so, or it waits out the timeout or invents an answer.
+    lines.push(`  or ${call('"declined": true')}                    (nobody can decide)`);
+    return lines;
+};
+/**
+ * What `next_question` hands the parent agent.
+ *
+ * Text, and in the same order a model task's envelope uses: how to handle it, what to call
+ * afterwards, then the material — so a model that stops reading early has still read the
+ * instruction. The question id appears at the top and in the follow-up call because it is the only
+ * thing that routes an answer back.
+ *
+ * The one thing this envelope says that the task envelope inverts: **do not isolate it**. A model
+ * task is handed to a clean subagent precisely so no context leaks into it; a question is handed to
+ * a PERSON, and a subagent has none. So there is no harness-specific isolation wording here at
+ * all — the harness is carried only because the caller has it and a future difference would belong
+ * beside the rest.
+ *
+ * The declined line is present on every question, whatever its kind. A parent whose user is not
+ * available has to have a way to say so: without one it either waits out a 45-minute timeout or
+ * invents an answer, and the second is worse.
+ */
+export const renderQuestionEnvelope = (inquiry, _opts) => {
+    const traits = [
+        ...(inquiry.multiple === true ? ['pick one or more'] : []),
+        ...(inquiry.allowText === true ? ['their own words are accepted instead of an option'] : []),
+    ];
+    const lines = [
+        `=== VIABLE QUESTION ${inquiry.id} ===`,
+        `kind: ${inquiry.kind}${traits.length > 0 ? ` · ${traits.join(' · ')}` : ''}`,
+        ...(inquiry.expiresAt != null ? [`expires: ${inquiry.expiresAt}`] : []),
+        '',
+        'HOW TO ANSWER THIS (do not answer it yourself):',
+        'Put this question to the person you are working for, in your own words. It is a decision about',
+        'THEIR project, and a guess here is a whole application built on the wrong assumption. If they',
+        'are not available, say so — do not invent an answer.',
+        '',
+        'WHAT TO SEND BACK — call exactly:',
+        ...answerCalls(inquiry),
+        '',
+        '--- THE QUESTION ---',
+        inquiry.question,
+    ];
+    if (inquiry.context != null && inquiry.context !== '') {
+        lines.push('--- BACKGROUND ---', inquiry.context);
+    }
+    if (inquiry.options != null && inquiry.options.length > 0) {
+        lines.push('--- OPTIONS ---');
+        for (const option of inquiry.options) {
+            lines.push(`  ${option.value} — ${option.label}`);
+            if (option.description != null && option.description !== '') {
+                lines.push(`      ${option.description}`);
+            }
+        }
+    }
+    if (inquiry.default != null) {
+        lines.push('--- IF NOBODY ANSWERS ---', `The platform will assume: ${Array.isArray(inquiry.default) ? inquiry.default.join(', ') : inquiry.default}`);
+    }
+    lines.push(`=== END QUESTION ${inquiry.id} ===`);
+    return lines.join('\n');
+};
+/** The offered values, listed so a refusal is actionable without re-reading the envelope. */
+const offered = (inquiry) => (inquiry.options ?? []).map(option => option.value).join(', ');
+const asStrings = (value) => {
+    if (typeof value === 'string')
+        return [value];
+    if (Array.isArray(value) && value.every(entry => typeof entry === 'string')) {
+        return value;
+    }
+    return null;
+};
+/**
+ * Check what the parent sent against the question that asked for it, before the platform sees it.
+ *
+ * The same rule the model-task parser follows, for the same reason: a refusal caught here is a
+ * sentence the parent can act on immediately, with the person still in front of it, while one the
+ * platform catches costs a round trip on a question a human already answered. So a mismatch comes
+ * back as a `problem` rather than a throw, and every problem names what WOULD be accepted.
+ *
+ * `declined` short-circuits everything. It is a real answer — somebody saw the question and chose
+ * not to decide — and reading anything else beside it would let a parent both decline and answer.
+ */
+export const parseAnswer = (inquiry, raw) => {
+    if (raw.declined === true) {
+        return { answer: { inquiryId: inquiry.id, declined: true } };
+    }
+    const text = typeof raw.text === 'string' ? raw.text.trim() : '';
+    const values = asStrings(raw.answer);
+    const hasAnswer = raw.answer != null;
+    if (!hasAnswer && text === '') {
+        return { problem: 'Send an answer, a text, or declined: true.' };
+    }
+    if (inquiry.kind === ConnectInquiryKind.Confirm) {
+        // A boolean is accepted as readily as a word: the tool's own schema offers `answer` as a
+        // string, and a model that sent `true` anyway has said exactly what was asked for.
+        const said = typeof raw.answer === 'boolean'
+            ? String(raw.answer)
+            : values?.[0] ?? text;
+        const confirmed = CONFIRM_WORDS[said.trim().toLowerCase()];
+        if (confirmed == null) {
+            return { problem: `Answer this one with "${CONFIRM_YES}" or "${CONFIRM_NO}".` };
+        }
+        return { answer: { inquiryId: inquiry.id, value: confirmed } };
+    }
+    if (inquiry.kind === ConnectInquiryKind.Choice) {
+        const known = new Set((inquiry.options ?? []).map(option => option.value));
+        if (known.size < 1) {
+            // A choice question that arrived carrying no choices. Nothing on the wire refuses one —
+            // `options` is optional and only the free-flight `ask_user` tool enforces the 2..max rule —
+            // and the value check below used to skip an empty set, so ANY string was recorded as a
+            // chosen value the asker can match against nothing, while the refusal that did fire read
+            // "one of the choices ()". The envelope prints `text` as the call for this shape, so text
+            // is what is taken back; a value is refused by naming the field that works.
+            return text !== ''
+                ? capText(inquiry, { inquiryId: inquiry.id, text })
+                : {
+                    problem: 'This question offers no choices — send `text` with what they said,'
+                        + ' or declined: true.',
+                };
+        }
+        if (values == null || values.length < 1) {
+            // Text alone is an answer only where the question said so. Elsewhere it is a value the
+            // asker cannot match against anything it offered, and accepting it silently loses the
+            // decision the person actually made.
+            if (inquiry.allowText === true && text !== '') {
+                return capText(inquiry, { inquiryId: inquiry.id, text });
+            }
+            return {
+                problem: `Answer with one of the choices (${offered(inquiry)})`
+                    + `${inquiry.allowText === true ? ', or send `text` with what they said' : ''}.`,
+            };
+        }
+        if (values.length > 1 && inquiry.multiple !== true) {
+            return { problem: `This question takes ONE answer (${offered(inquiry)}).` };
+        }
+        for (const value of values) {
+            if (!known.has(value)) {
+                return { problem: `"${value}" is not one of the choices (${offered(inquiry)}).` };
+            }
+        }
+        // Through the same ceiling as every other text: a chosen value may carry the person's own
+        // words beside it, and that rider is the one path a length the wire schema refuses could
+        // otherwise take — refused there, it costs a round trip on a question already answered.
+        return capText(inquiry, {
+            inquiryId: inquiry.id,
+            value: inquiry.multiple === true ? values : values[0],
+            ...(text !== '' ? { text } : {}),
+        });
+    }
+    const said = text !== '' ? text : (values?.join('\n') ?? '').trim();
+    if (said === '') {
+        return { problem: 'Send what they said as `text`.' };
+    }
+    return capText(inquiry, { inquiryId: inquiry.id, text: said });
+};
+/**
+ * The ONE ceiling, refused rather than silently applied.
+ *
+ * Cutting the text here would hand the asker most of a decision and say nothing; the person is
+ * still in front of the parent, so the honest answer is to ask them to be shorter and to say where
+ * a longer answer belongs.
+ */
+const capText = (inquiry, answer) => (answer.text?.length ?? 0) > CONNECT_INQUIRY_MAX_TEXT
+    ? {
+        problem: `Too long — send at most ${CONNECT_INQUIRY_MAX_TEXT} characters; put anything`
+            + ' longer in the project instead.',
+    }
+    : { answer: { ...answer, inquiryId: inquiry.id } };
+//# sourceMappingURL=inquiry.js.map

package/build/task/inquiry.js.map

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

package/build/tools/catalogue.d.ts

@@ -0,0 +1,17 @@
+import type { ToolDefinition, ToolHost } from './types.js';
+import { ToolHostKind } from './types.js';
+/**
+ * Everything a parent agent can ask the platform to do.
+ *
+ * Two rules shape the whole list. Every tool answers inside the strictest host's per-tool ceiling,
+ * so anything that takes minutes returns a JOB at once and is polled — a coding agent that blocks
+ * for twenty minutes is reported to its user as a hung server. And every tool that cannot work in
+ * a given mode is HIDDEN rather than failing, so the catalogue a parent reads is exactly the set
+ * of things that work for it.
+ */
+export declare const catalogue: ToolDefinition[];
+/** The tools a given host actually offers. */
+export declare const visibleTools: (host: ToolHost) => ToolDefinition[];
+export declare const toolByName: (name: string) => ToolDefinition | undefined;
+export { ToolHostKind };
+//# sourceMappingURL=catalogue.d.ts.map

package/build/tools/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../src/tools/catalogue.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAY,cAAc,EAAE,QAAQ,EAAc,MAAM,YAAY,CAAA;AAChF,OAAO,EACkE,YAAY,EACpF,MAAM,YAAY,CAAA;AA2SnB;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,EAAE,cAAc,EAqhCrC,CAAA;AAaD,8CAA8C;AAC9C,eAAO,MAAM,YAAY,SAAU,QAAQ,KAAG,cAAc,EACT,CAAA;AAEnD,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,cAAc,GAAG,SACf,CAAA;AAE5C,OAAO,EAAE,YAAY,EAAE,CAAA"}