@owlmeans/viable-sdk 0.1.18-rc.1

package/build/tools/platform.js

@@ -0,0 +1,316 @@
+import { ConnectJobBlock, ConnectJobKind, ConnectLlm, ConnectTarget } from '@owlmeans/viable-common';
+import { JOB_POLL_MAX_SEC, NEXT_QUESTION_WAIT_MS, NEXT_TASK_WAIT_MS, TOOL_DEADLINE_MS } from '../consts.js';
+import { visibleTools } from './catalogue.js';
+/**
+ * What the platform can build, as data.
+ *
+ * STATIC on purpose: `describe_platform` is the one tool that must answer before a token is valid
+ * for anything, because it is what a parent reads to decide whether to use the platform at all.
+ * Every pipeline a parent can poll for has an entry — the list is checked against
+ * {@link ConnectJobKind}, so a job kind added without a description here fails a test rather than
+ * reaching a parent as a job it cannot interpret.
+ */
+export const PLATFORM_CATALOGUE = {
+    pipelines: [
+        {
+            id: 'vib:project:create',
+            title: 'Draft a project from a description',
+            what: 'Writes the specification, names the application and drafts its vision. Nothing is'
+                + ' built and no code is generated until the draft is confirmed.',
+            startedBy: ['create_project'],
+            resumable: false,
+            jobKind: ConnectJobKind.ProjectCreate,
+        },
+        {
+            id: 'vib:project:init',
+            title: 'Build the whole application',
+            what: 'Lays the template down, installs dependencies, configures the target, draws every'
+                + ' screen the analysis found as a placeholder, and builds it. The long one.',
+            startedBy: ['confirm_project'],
+            stages: [
+                'template', 'dependencies', 'serve', 'styles', 'metadata', 'primary', 'scaffold', 'build',
+            ],
+            resumable: true,
+            blocks: [ConnectJobBlock.ModelTask, ConnectJobBlock.LocalOp, ConnectJobBlock.Env],
+            jobKind: ConnectJobKind.ProjectInit,
+        },
+        {
+            id: 'vib:project:reinit',
+            title: 'Lay the template down again',
+            what: 'Wipes the generated sources and rebuilds from the template. The user stories are kept'
+                + ' and reset to planned; configuration and git history survive.',
+            startedBy: ['reinitialize_project'],
+            resumable: true,
+            blocks: [ConnectJobBlock.ModelTask, ConnectJobBlock.LocalOp],
+            jobKind: ConnectJobKind.ProjectReinit,
+        },
+        {
+            id: 'vib:story:develop',
+            title: 'Implement one user story',
+            what: 'Designs the story, then implements it: types, data, endpoints, access, state,'
+                + ' components, screens and navigation, then checks that the application still boots.',
+            startedBy: ['develop_story'],
+            stages: ['design', 'implement', 'widget', 'boot gate'],
+            resumable: true,
+            blocks: [ConnectJobBlock.ModelTask, ConnectJobBlock.LocalOp],
+            jobKind: ConnectJobKind.StoryDevelop,
+        },
+        {
+            id: 'free flight',
+            title: 'An open-ended change',
+            what: 'The platform\'s own coding agent makes a change described in words — a rename, a fix,'
+                + ' a styling pass. For anything that is not a user story.',
+            startedBy: ['modify_project'],
+            resumable: true,
+            blocks: [ConnectJobBlock.ModelTask, ConnectJobBlock.LocalOp],
+            jobKind: ConnectJobKind.FreeFlight,
+        },
+        {
+            id: 'resume',
+            title: 'Continue a run that stopped',
+            what: 'Picks a crashed or interrupted run up at the step it stopped on rather than starting'
+                + ' it over. Answers a job of the run it resumed.',
+            startedBy: ['resume_pipeline'],
+            resumable: true,
+            jobKind: ConnectJobKind.PipelineResume,
+        },
+        {
+            id: 'vib:project:convert:intake',
+            title: 'Read an application you already have',
+            what: 'Takes stock of an existing codebase: what it is built with, what shape it has, how'
+                + ' much of it can be converted and what that will cost. Ends at your decision.',
+            startedBy: ['convert_project'],
+            resumable: true,
+            blocks: [ConnectJobBlock.Question, ConnectJobBlock.ModelTask, ConnectJobBlock.LocalOp],
+            jobKind: ConnectJobKind.ConvertIntake,
+        },
+        {
+            id: 'vib:project:convert:analysis',
+            title: 'Restore the analysis nobody wrote',
+            what: 'Reads the origin layer by layer and produces the specification, the design and the'
+                + ' main flow the platform would have written for it, then bootstraps a target around it.',
+            startedBy: ['proceed_conversion'],
+            resumable: true,
+            blocks: [ConnectJobBlock.Question, ConnectJobBlock.ModelTask, ConnectJobBlock.LocalOp],
+            jobKind: ConnectJobKind.ConvertAnalysis,
+        },
+        {
+            id: 'vib:project:convert:extraction',
+            title: 'Recover the user stories',
+            what: 'Extracts every user story out of the origin with proofs from its code, assigns each'
+                + ' to an area, and prices implementing them.',
+            startedBy: ['proceed_conversion'],
+            resumable: true,
+            blocks: [ConnectJobBlock.Question, ConnectJobBlock.ModelTask, ConnectJobBlock.LocalOp],
+            jobKind: ConnectJobKind.ConvertExtraction,
+        },
+        {
+            id: 'vib:project:convert:implementation',
+            title: 'Re-implement it on the platform',
+            what: 'Develops every extracted story with the ordinary story pipeline, with the origin kept'
+                + ' beside it as evidence.',
+            startedBy: ['proceed_conversion'],
+            resumable: true,
+            blocks: [ConnectJobBlock.ModelTask, ConnectJobBlock.LocalOp],
+            jobKind: ConnectJobKind.ConvertImplementation,
+        },
+        {
+            id: 'purge',
+            title: 'Delete the converted origin',
+            what: 'Removes the original sources kept beside the converted project, and rewrites the'
+                + ' conversion documents so they stop quoting them. Cannot be undone.',
+            startedBy: ['purge_origin'],
+            resumable: false,
+            jobKind: ConnectJobKind.ConvertPurge,
+        },
+    ],
+    capabilities: [
+        {
+            id: 'projects',
+            title: 'Projects',
+            what: 'Create one, read what was drafted, list what this account has, and point the'
+                + ' connector at an existing one.',
+            tools: [
+                'describe_capabilities', 'create_project', 'confirm_project', 'project_status',
+                'list_projects', 'attach_project', 'reinitialize_project',
+            ],
+            absent: 'no project tools are offered here',
+        },
+        {
+            id: 'stories',
+            title: 'User stories',
+            what: 'List, search, add, reword and delete stories, and ask for one to be implemented.',
+            tools: [
+                'list_stories', 'search_stories', 'create_story', 'update_story', 'delete_story',
+                'develop_story', 'story_status',
+            ],
+            absent: 'no story tools are offered here',
+        },
+        {
+            id: 'runs',
+            title: 'Runs and jobs',
+            what: 'Poll a job, read where a run stopped, continue it, and see what this connector is'
+                + ' currently doing.',
+            tools: ['wait_for', 'pipeline_status', 'resume_pipeline', 'session_status'],
+            absent: 'no job tools are offered here',
+        },
+        {
+            id: 'free-flight',
+            title: 'An open-ended change',
+            what: 'Describe a change in words and let the platform\'s own coding agent make it — for'
+                + ' anything that is not a user story.',
+            tools: ['modify_project'],
+            absent: 'open-ended changes are not offered here',
+        },
+        {
+            // The order of `tools` is the order a parent reads them in, and for this group it is the
+            // workflow rather than an alphabet: `check_convertible` reports what the INTAKE found, so
+            // the platform refuses it before a conversion has been started. Leading with it printed
+            // check-first over a platform that answers a check with a refusal, and contradicted both the
+            // tool's own description and `serverInstructions` — two texts on one server saying opposite
+            // things is how a parent invents a third behaviour.
+            id: 'conversion',
+            title: 'Converting an application you already have',
+            what: 'Start a conversion of a codebase you already have, decide at each stage, read where it'
+                + ' stands and what the intake made of the tree, and delete the origin afterwards.',
+            tools: [
+                'convert_project', 'proceed_conversion', 'conversion_status', 'check_convertible',
+                'purge_origin',
+            ],
+            absent: 'conversion is not offered here',
+        },
+        {
+            id: 'model-tasks',
+            title: 'Performing the platform\'s model calls',
+            what: 'The platform hands a model call to you as a task to run in a clean subagent, and'
+                + ' spends none of the account\'s credits on it — a conversion\'s calls by default, and'
+                + ' everything else in the delegated mode.',
+            tools: ['next_task', 'submit_task_result'],
+            absent: 'this server holds no session, so a task cannot be delivered through it — the'
+                + ' platform performs its own model calls instead',
+        },
+        {
+            id: 'questions',
+            title: 'Answering for a person',
+            what: 'The platform asks a decision that is the user\'s to make, and you carry the question'
+                + ' to them and the answer back.',
+            tools: ['next_question', 'answer_question'],
+            absent: 'this server holds no session, so a question cannot be delivered through it — the'
+                + ' platform assumes an answer and records the assumption instead',
+        },
+        {
+            id: 'local',
+            title: 'Running the application on this machine',
+            what: 'What the generated project still needs to start here, the database and queue the user'
+                + ' supplies, and starting and stopping it.',
+            tools: ['local_status', 'run_local', 'stop_local', 'local_setup_guide', 'set_local_service'],
+            absent: 'this project\'s sources live in a platform slot, not on this machine',
+        },
+        {
+            id: 'harness',
+            title: 'Setting this agent up',
+            what: 'Preview and write the instruction and subagent files this coding agent needs.',
+            tools: ['describe_harness', 'install_harness'],
+            absent: 'this server writes no files, so it cannot install a harness',
+        },
+        {
+            id: 'files',
+            title: 'The generated sources',
+            what: 'Read what the platform generated for a project whose tree lives in its own slot.',
+            tools: ['list_files'],
+            absent: 'the sources are on this machine — read them directly',
+        },
+    ],
+    limits: {
+        toolDeadlineMs: TOOL_DEADLINE_MS,
+        jobPollMaxSec: JOB_POLL_MAX_SEC,
+        nextTaskWaitMs: NEXT_TASK_WAIT_MS,
+        nextQuestionWaitMs: NEXT_QUESTION_WAIT_MS,
+    },
+    modes: {
+        targets: [ConnectTarget.Cloud, ConnectTarget.Local],
+        llms: [ConnectLlm.Cloud, ConnectLlm.Local],
+    },
+};
+/**
+ * The catalogue as text, narrowed to what THIS session can drive.
+ *
+ * Two rules, and the second is the point. Nothing is listed that the host does not offer, so a
+ * parent never proposes a path it cannot take. And every group that IS hidden says so in one line,
+ * because a parent reading a shorter list without an explanation concludes the platform cannot do
+ * the thing at all — and then writes the application by hand.
+ *
+ * Deterministic: no clock, no host name, no ordering that depends on a map. Two calls with the
+ * same host produce the same bytes, which is what makes it safe to cache in a system prompt.
+ */
+export const renderPlatform = (catalogue, host) => {
+    const offered = new Set(visibleTools(host).map(tool => tool.name));
+    const has = (tool) => offered.has(tool);
+    const lines = [
+        'THE OWLMEANS VIABLE PLATFORM',
+        '',
+        'It builds full-stack web applications from a description, and converts applications that'
+            + ' already exist onto the same rails. Everything below is what the platform does; the'
+            + ' "in this session" notes say which of it you can drive from here.',
+        '',
+        `This session: target=${host.target} (${host.target === ConnectTarget.Local
+            ? 'the sources live on this machine'
+            : 'the sources live in a platform slot'}), llm=${host.llm} (${
+        // Read off the offered set FIRST, and only then off the mode. A host that cannot hold a
+        // session cannot collect a task whatever the account setting says — and the setting is
+        // `local` there often enough (an entitled account gets it on the URL host too) that
+        // branching on the mode first told such a parent to poll a `next_task` it was never
+        // offered, which it reports as a broken server. Above that floor a conversion delegates to
+        // any session that can hold one, so a `cloud` session that CAN collect must not be told
+        // the platform performs everything — it would stop polling.
+        !has('next_task')
+            ? 'the platform performs its own model calls — this session cannot collect one'
+            : host.llm === ConnectLlm.Local
+                ? 'the platform\'s model calls are yours to perform'
+                : 'the platform performs its own model calls, except a conversion\'s — those are yours'
+                    + ' by default'}).`,
+        '',
+        'WHAT IT RUNS',
+    ];
+    for (const pipeline of catalogue.pipelines) {
+        const startable = pipeline.startedBy.filter(has);
+        lines.push('', `  ${pipeline.title} · ${pipeline.id}`, `    ${pipeline.what}`, startable.length > 0
+            ? `    start: ${startable.join(' or ')}`
+            : `    not startable in this session (${pipeline.startedBy.join(', ')} is not offered here)`);
+        if (pipeline.stages != null)
+            lines.push(`    steps: ${pipeline.stages.join(' → ')}`);
+        lines.push(`    ${pipeline.resumable ? 'resumable — resume_pipeline continues it' : 'not resumable'}`
+            + (pipeline.jobKind != null ? ` · job kind: ${pipeline.jobKind}` : ''));
+        if (pipeline.blocks != null && pipeline.blocks.length > 0) {
+            lines.push(`    may block on: ${pipeline.blocks.join(', ')}`);
+        }
+    }
+    lines.push('', 'WHAT YOU CAN CALL');
+    const hidden = [];
+    for (const capability of catalogue.capabilities) {
+        const available = capability.tools.filter(has);
+        if (available.length < 1) {
+            hidden.push(capability);
+            continue;
+        }
+        lines.push('', `  ${capability.title}`, `    ${capability.what}`, `    ${available.join(', ')}`);
+    }
+    if (hidden.length > 0) {
+        lines.push('', 'NOT IN THIS SESSION (the platform does it; this connector cannot)');
+        for (const capability of hidden) {
+            lines.push(`  ${capability.title} — ${capability.absent}`);
+        }
+    }
+    lines.push('', 'LIMITS', `  every tool answers within ${Math.round(catalogue.limits.toolDeadlineMs / 1000)}s — anything`
+        + ' longer is a job you poll', `  wait_for holds for at most ${catalogue.limits.jobPollMaxSec}s per call`, 
+    // Named only where the tool is offered: a limit for a call that is not in the list is an
+    // invitation to make it.
+    ...(has('next_task')
+        ? [`  next_task waits up to ${Math.round(catalogue.limits.nextTaskWaitMs / 1000)}s`]
+        : []), ...(has('next_question')
+        ? [`  next_question waits up to ${Math.round(catalogue.limits.nextQuestionWaitMs / 1000)}s`]
+        : []), '', 'Publishing to production, custom domains and billing are done by the user in the web'
+        + ' application, and are deliberately not offered through a connector.');
+    return lines.join('\n');
+};
+//# sourceMappingURL=platform.js.map

package/build/tools/platform.js.map

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

package/build/tools/refusal.d.ts

@@ -0,0 +1,66 @@
+/**
+ * One refusal: the marker it travels as, and the sentence a parent agent reads instead of it.
+ *
+ * The marker is matched as a SUBSTRING of the error's own message, never by class. Every refusal
+ * the platform raises is declared in a package this one does not depend on — the conversion family
+ * in the platform's `viable-common`, the converter's own in `@owlmeans/viable-converter` — so an
+ * `instanceof` here is impossible, and `ResilientError.ensure` rebuilds an unregistered class as a
+ * bare error carrying the whole marshalled string. The same rule the browser follows for the same
+ * reason: a refusal arrives thrown from a call AND stored as text on a job that failed, and only
+ * the marker survives both.
+ */
+export interface RefusalPhrase {
+    /** The marker as it appears inside the message, without the package prefix where that is safe. */
+    marker: string;
+    /** The sentence, given whatever followed the marker (`''` where nothing did). */
+    phrase: (detail: string) => string;
+}
+/**
+ * Every refusal a connector can be handed, and the one sentence it is handed instead.
+ *
+ * Ordered by SPECIFICITY, because the first marker the message contains wins: every reason of a
+ * family sits above the family's own marker, or the family would answer for all of them. A marker
+ * that is a substring of a later one is a marker that shadows it, which `catalogue.spec.ts` pins
+ * rather than leaves to review.
+ *
+ * The markers are literals here on purpose. They are wire text owned by packages this one does not
+ * depend on, and copying the constant would need a dependency edge from a tooling package onto the
+ * platform's own — so they are spelled once, in the order the platform spells them, and are
+ * exactly the substrings the manager's own phrasing matches on. Anything unmatched falls back to
+ * its marker, which is the one outcome that stays honest as the platform grows a refusal this
+ * table has never heard of.
+ */
+export declare const REFUSALS: RefusalPhrase[];
+/**
+ * What a refusal SAYS, with the marshalling and the stack taken off it.
+ *
+ * A marshalled error is `type|||message|||stack`, so the middle segment is the marker and the last
+ * one is a stack trace from a machine the reader has no access to. What is left is the marker
+ * alone — which is the fallback whenever nothing in {@link REFUSALS} recognises it, because a
+ * marker names the refusal even when no sentence has been written for it yet.
+ *
+ * Text that was never marshalled is returned exactly as it is. A stack only ever arrives inside
+ * the marshalling, and the same field carries things that are not refusals at all — a job's
+ * `error` doubles as the build warning a slot recorded, and cutting that at the first line that
+ * looks like a stack frame would throw away the diagnostics somebody asked for.
+ */
+export declare const refusalMessage: (e: unknown) => string;
+/** Said where the platform refused and said nothing about why at all. */
+export declare const UNKNOWN_REFUSAL: string;
+/** Said after a marker no sentence has been written for: the marker names it, this says what next. */
+export declare const UNPHRASED_REFUSAL: string;
+/**
+ * The one sentence a parent agent is given for anything that refused it.
+ *
+ * The reader is a language model holding a tool result, and it acts on what it reads: a marshalled
+ * type name followed by a stack trace tells it only that something went wrong somewhere, so it
+ * retries a call that can never succeed, or reports the server as broken. A refusal is an ANSWER —
+ * this origin is the project, that decision is not available here, the balance will not cover it —
+ * and every one of them has something the parent should do next.
+ *
+ * An unknown marker keeps that property rather than dropping it: the marker stays, because it is
+ * the honest answer as the platform grows refusals faster than phrasings, and {@link
+ * UNPHRASED_REFUSAL} names the tool to call — a parent left holding wire text alone has neither.
+ */
+export declare const refusalPhrase: (e: unknown) => string;
+//# sourceMappingURL=refusal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../../src/tools/refusal.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;CACnC;AAiBD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,EAAE,aAAa,EA8OnC,CAAA;AA6DD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,MAAO,OAAO,KAAG,MAI3C,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,eAAe,QACkD,CAAA;AAE9E,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,QAEuC,CAAA;AAYrE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,MAAO,OAAO,KAAG,MAa1C,CAAA"}