@owlmeans/viable-common 0.0.45 → 0.0.46

package/README.md

@@ -17,11 +17,12 @@ filesystem, no inference SDK. It is safe to import from a browser bundle.
 | `@owlmeans/viable-common/connect` | The connector protocol: sessions, operations, model tasks, questions, domain statuses, capabilities, the error family, and `connectProtocols()` — the one declaration both the platform and the SDK bind |
 | `@owlmeans/viable-common/convert` | Converting an application that already exists: the stages and their transitions, the origin and stack taxonomy, the census classifiers, and the `docs/conversion/` layout |
 | `@owlmeans/viable-common/integrity` | The target-shape manifest — what a slot is allowed to install, build and run — per target layout |
+| `@owlmeans/viable-common/legal` | `OWLMEANS_LEGAL_DATES`, `LegalDocumentDates` and `LegalDocumentKey` — shared ISO dates for the public site's policies and the platform's legal acceptance; no runtime dependencies |
 
 ## Installation
 
 ```bash
-bun add @owlmeans/viable-common@^0.0.45
+bun add @owlmeans/viable-common@^0.0.46
 ```
 
 ## Rules worth knowing before you change something
@@ -39,7 +40,7 @@ means "inherit" has no other spelling. `tests/convert.spec.ts` walks every expor
 both faults, and for draft-04 tuple `items`.
 
 **A field that crosses a version skew carries no `enum`.** A connector is installed with
-`npx -y @owlmeans/viable-mcp@^0.1.18-rc.45` and talks to a separately deployed platform, so an executor kind it
+`npx -y @owlmeans/viable-mcp@^0.1.18-rc.46` and talks to a separately deployed platform, so an executor kind it
 sends must remain an unused capability on an older platform rather than a refused session.
 
 **A ceiling exists once.** The inquiry answer cap here equals `DEFAULT_INQUIRY_ANSWER_CHARS` in
@@ -59,7 +60,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.49
+npx @owlmeans/agent-skills@^0.1.18-rc.51
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/viable-common",
-  "version": "0.0.45",
-  "generatedAt": "2026-10-05T21:03:06.405Z",
+  "version": "0.0.46",
+  "generatedAt": "2026-10-06T11:45:57.674Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/agent-presentation/SKILL.md

@@ -6,7 +6,7 @@ description: Shared, runtime-free taxonomy for presenting OwlMeans Viable agent
 
 # Agent output presentation
 
-**Install:** `"@owlmeans/viable-common": "^0.0.45"` in `dependencies`
+**Install:** `"@owlmeans/viable-common": "^0.0.46"` in `dependencies`
 
 `@owlmeans/viable-common`'s `agent/presentation.ts` owns the browser-safe vocabulary for agent
 output. Keep the server and every client on `agentPresentationHelper.classifyAgentMessage()`; consumers may refine a

package/agent-meta/skills/viable-common/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: viable-common
-description: How to use @owlmeans/viable-common — the runtime-free contract package of the OwlMeans Viable platform. Covers planning cards and flows (including the landing-gate and tenancy fields), project/story refusals, slot commands and layouts, slot metadata keys, target integrity, connector domain statuses and routes, the intent-first hand-off (`./intent`), conversion vocabulary, blueprint layer types and the case vocabulary, the ViableSkill/ViablePersona names (never the catalogue behind them), what belongs here versus in @owlmeans/viable, generated-project analysis/design/scaffold/metadata shapes, StoryDesignPort, schema conventions, and wire-version rules. Auto-invoked when importing a viable card type or flow, a slot command, a connector or conversion type, a target-integrity helper, or any *Schema this package exports.
+description: How to use @owlmeans/viable-common — the runtime-free contract package of the OwlMeans Viable platform. Covers planning cards and flows (including the landing-gate and tenancy fields), project/story refusals, slot commands and layouts, slot metadata keys, target integrity, connector domain statuses and routes, the intent-first hand-off (`./intent`), shared legal dates (`./legal`), conversion vocabulary, blueprint layer types and case vocabulary, ViableSkill/ViablePersona names, what belongs here versus in @owlmeans/viable, generated-project analysis/design/scaffold/metadata shapes, StoryDesignPort, schema conventions, and wire-version rules. Auto-invoked when importing a viable card type or flow, a slot command, a connector or conversion type, legal dates, a target-integrity helper, or any *Schema this package exports.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,8 +8,8 @@ user-invocable: false
 # @owlmeans/viable-common
 
 **Layer:** Cross-cutting domain (contracts only)
-**Install:** `"@owlmeans/viable-common": "^0.0.45"` in `dependencies`
-**Subpaths:** `.` · `./slot` · `./connect` · `./convert` · `./integrity` · `./intent` — the barrel
+**Install:** `"@owlmeans/viable-common": "^0.0.46"` in `dependencies`
+**Subpaths:** `.` · `./slot` · `./connect` · `./convert` · `./integrity` · `./intent` · `./legal` — the barrel
 re-exports every subpath except `./intent`.
 **Runtime-free:** no `@langchain/*`, no filesystem, no Ajv at run time (a devDependency, for the
 tests that compile the schemas); it depends on the packages under Depends On and nothing else.
@@ -37,6 +37,23 @@ execution state and card fields name.
 | `./convert` | `ConversionStage`/`Status`/`Decision` and the `conversionStageHelper` transitions (`stageAfter`/`decisionFor`/`canEnter`), `OriginKind`/`OriginShape`/`OriginState`, `StackId` + `STACK_FAMILY`, `ArchitectureCase`, `ConvertibilityVerdict`/`ConvertibilityReason`, the census classifiers (`censusHelper` — `fileClassOf`, `sizeClassOf`, `entropyClassOf`, `binaryByExtension`), the `docs/conversion/` paths, `CONVERTED_ORIGIN_DIR`, `SOURCE_LIST_EXCLUSIONS`, `CENSUS_SKIP_DIRS`, `RELOCATE_ALWAYS_KEEP`, and the model-answer schemas the conversion asks with |
 | `./integrity` | `TargetLayout` + `TARGET_LAYOUTS`, `targetLayoutHelper` (`detectTargetLayout`, `isLegacyLayout`, `targetPackageName`), `targetIntegrityHelper.verifyTargetShape`, `TARGET_INTEGRITY_FILES`, `TARGET_PROTECTED_FILES` |
 | `./intent` | `intent` (the four aliases), `makeIntentProtocols(opts?)`, `intentFlow` + `IntentFlowStep` + `INTENT_PAYLOAD_REF`, `IntentStashBodySchema` / `IntentPickupBodySchema`, the `INTENT_*` constants, `IntentDraft`, `IntentExpired` (404) / `IntentThrottled` (429) |
+| `./legal` | `OWLMEANS_LEGAL_DATES`, `LegalDocumentDates`, `LegalDocumentKey` — the public site's legal dates and the platform's legal acceptance dates |
+
+## Shared legal dates (`./legal`)
+
+Import `OWLMEANS_LEGAL_DATES` from `@owlmeans/viable-common/legal` for legal-page builds and
+platform consent configuration. This subpath has no runtime imports; it loads only the date table.
+The package barrel also re-exports it. Never import another repository's sources by path.
+
+`src/legal/consts.ts` owns the ISO `YYYY-MM-DD` effective/updated dates; `src/legal/types.ts`
+declares `LegalDocumentDates` and the complete `LegalDocumentKey` union. A new document must add
+both a key and a table row; `satisfies Record<LegalDocumentKey, LegalDocumentDates>` checks coverage.
+Format dates in the consumer's locale, keeping policy text as placeholders rather than copied dates.
+
+Changing a terms/privacy/billing/product updated date changes the platform's terms-acceptance
+digest and requires acceptance again; privacy.updated also revises marketing consent.
+Cookies, services-agreement and platform-license dates are display-only. Rebuild this package
+before the platform and static-site consumers; both must receive the same table revision.
 
 ## The planning module
 

package/build/connect/ops.d.ts

@@ -0,0 +1,189 @@
+import type { SlotCommandPayload } from '../slot/index.js';
+import type { ConnectInquiryKind, ConnectOpErrorKind, ConnectOpKind, ModelTaskMode, ModelTaskResultKind, ModelTaskRole, ModelTier } from './consts.js';
+import type { ConnectServices } from './types.js';
+/**
+ * One thing the platform asks a connector to do.
+ *
+ * Operations are addressed to a PROJECT, not to a session: a connector that restarts mid-run
+ * re-attaches and is handed whatever is still pending, so an MCP server dying does not kill a
+ * pipeline that is minutes into its work. `sessionId` records which session it was published to,
+ * for tracing and for the redelivery counter — never for routing a result back.
+ */
+export interface ConnectOp {
+    id: string;
+    projectId: string;
+    sessionId: string;
+    kind: ConnectOpKind;
+    payload: SlotCommandPayload | ModelTask | ConfigurePayload | InquiryPayload;
+    createdAt: string;
+    /** When the asker stops waiting. A connector past this may skip the work and say so. */
+    deadlineAt: string;
+    /** How many times this op has been delivered. > 1 means a connector reconnected. */
+    attempt: number;
+    deliveredAt?: string;
+}
+/**
+ * The answer to exactly one operation.
+ *
+ * `ok: false` with `kind: 'malformed'` is a RETRYABLE outcome — the platform asks again, with the
+ * problem quoted back. `'unavailable'` says the connector cannot do this at all and the run should
+ * fail rather than spin.
+ */
+export interface ConnectOpResult {
+    opId: string;
+    sessionId: string;
+    ok: boolean;
+    value?: unknown;
+    error?: ConnectOpError;
+}
+export interface ConnectOpError {
+    type: string;
+    message: string;
+    kind?: ConnectOpErrorKind;
+}
+/**
+ * The configuration a local target needs, as file CONTENT rather than as keys.
+ *
+ * The platform composes it — it is the only side that knows the OIDC client, its secret and the
+ * redirect URIs — and the connector writes it into the managed block of each named file, leaving
+ * every line the user added alone. `probe` names the services the platform wants to know about
+ * before it asks for a database migration or a boot check.
+ */
+export interface ConfigurePayload {
+    files: ConfigureFile[];
+    probe: Array<keyof ConnectServices>;
+}
+export interface ConfigureFile {
+    /** Target-root-relative, e.g. `.env` or `sources/web/.env`. */
+    path: string;
+    /** The managed block's content. Written between the connector's own markers. */
+    content: string;
+}
+export interface ConfigureResult {
+    written: string[];
+    /**
+     * Keys the target still needs and the user must supply — a local database URL, say.
+     *
+     * Read exactly like the publisher's configure acknowledgement: a key with an EMPTY value counts
+     * as missing, because a push that ran before a secret existed leaves one behind.
+     */
+    missing: string[];
+    services: ConnectServices;
+}
+/**
+ * One model call, handed to the parent agent.
+ *
+ * It carries everything a fresh subagent needs and nothing it does not: the persona as a system
+ * prompt, the conversation so far, and the shape the answer must take. There is no platform
+ * vocabulary in it — no pipeline, no step, no internal role semantics beyond a name and a tier —
+ * because it is read by a model the platform does not own.
+ */
+export interface ModelTask {
+    id: string;
+    projectId: string;
+    /** The platform role that asked. Informational; the tier is what decides the model. */
+    role: string;
+    tier: ModelTier;
+    /** Which attempt this is. > 0 means a previous answer was refused; `feedback` says why. */
+    attempt: number;
+    mode: ModelTaskMode;
+    system?: string;
+    messages: ModelTaskMessage[];
+    /** `Tools` mode: what the subagent may call. JSON Schema per tool. */
+    tools?: ModelTaskTool[];
+    /** `Tools` mode: force one tool, or leave the choice open. */
+    toolChoice?: ModelTaskToolChoice;
+    /** `Json` mode: the schema the single returned object must satisfy. */
+    outputSchema?: Record<string, unknown>;
+    /** A soft cap, stated so a parent can size its own call. */
+    maxOutputChars?: number;
+    /** Present on a retry: what was wrong with the previous answer. */
+    feedback?: string;
+    expiresAt: string;
+}
+export interface ModelTaskMessage {
+    role: ModelTaskRole;
+    content: string;
+    /** Assistant messages that called tools. */
+    toolCalls?: ModelTaskToolCall[];
+    /** Tool messages answer one call. */
+    toolCallId?: string;
+    /** Tool messages name the tool they answer. */
+    name?: string;
+}
+export interface ModelTaskTool {
+    name: string;
+    description?: string;
+    /** JSON Schema for the tool's arguments. */
+    parameters: Record<string, unknown>;
+}
+export type ModelTaskToolChoice = 'auto' | 'none' | {
+    name: string;
+};
+export interface ModelTaskToolCall {
+    id?: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+/** What the parent's subagent produced. */
+export interface ModelTaskResult {
+    taskId: string;
+    kind: ModelTaskResultKind;
+    text?: string;
+    json?: unknown;
+    toolCalls?: ModelTaskToolCall[];
+    /** Why the parent could not answer. Treated as a malformed answer and retried. */
+    error?: string;
+    /** What the parent spent. Recorded for the trace; it costs the platform nothing. */
+    usage?: ModelTaskUsage;
+    /** What the parent actually ran. Display only. */
+    model?: string;
+}
+export interface ModelTaskUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+}
+/** One option a {@link ConnectInquiryKind.Choice} question offers. */
+export interface ConnectInquiryOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+/**
+ * One question put to the person the connector is working for.
+ *
+ * It carries where it came from — the run and the step — because an answer is recorded
+ * against the run that asked and re-read when that run resumes. `expiresAt` is what makes an
+ * unanswered question fail its step instead of parking a project lock forever.
+ */
+export interface InquiryPayload {
+    id: string;
+    projectId: string;
+    runId?: string;
+    /** The pipeline step that asked, so a resumed run can match the answer to the place it belongs. */
+    step?: string;
+    kind: ConnectInquiryKind;
+    question: string;
+    /** What the asker already knows, so the person is not asked to go and find it out. */
+    context?: string;
+    options?: ConnectInquiryOption[];
+    multiple?: boolean;
+    /** Whether a choice question also accepts text the options do not cover. */
+    allowText?: boolean;
+    /** What the asker will assume if nobody answers. Recorded as an assumption when it is used. */
+    default?: string | string[];
+    expiresAt: string;
+}
+/**
+ * The answer to one question.
+ *
+ * `declined` is a real answer and not an absence: it says a person saw the question and chose not
+ * to decide, which the asker records as an assumption rather than waiting out the timeout.
+ */
+export interface InquiryAnswerPayload {
+    inquiryId: string;
+    value?: string | string[];
+    text?: string;
+    declined?: boolean;
+}
+//# sourceMappingURL=ops.d.ts.map

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

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

package/build/connect/ops.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ops.js.map

package/build/connect/ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.js","sourceRoot":"","sources":["../../src/connect/ops.ts"],"names":[],"mappings":""}