@owlmeans/viable-common 0.0.48-rc.2 → 0.0.48-rc.4

package/README.md

@@ -15,7 +15,7 @@ the Viable platform has no use for it. The package's skills are `viable-common`
 ## Installation
 
 ```bash
-bun add @owlmeans/viable-common@^0.0.48-rc.2
+bun add @owlmeans/viable-common@^0.0.48-rc.4
 ```
 
 ## What is in it
@@ -209,7 +209,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.54
+npx @owlmeans/agent-skills@^0.1.18-rc.56
 ```
 
 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.48-rc.2",
-  "generatedAt": "2026-10-15T10:20:01.307Z",
+  "version": "0.0.48-rc.4",
+  "generatedAt": "2026-10-17T00:00:32.717Z",
   "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.48-rc.2"` in `dependencies`
+**Install:** `"@owlmeans/viable-common": "^0.0.48-rc.4"` 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

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/viable-common
 
 **Layer:** Cross-cutting domain (contracts only)
-**Install:** `"@owlmeans/viable-common": "^0.0.48-rc.2"` in `dependencies`
+**Install:** `"@owlmeans/viable-common": "^0.0.48-rc.4"` in `dependencies`
 **Subpaths:** `.` · `./slot` · `./connect` · `./convert` · `./integrity` · `./intent` · `./legal` · `./iam-console` — the barrel
 re-exports every subpath except `./intent`.
 **Runtime-free:** no `@langchain/*`, no filesystem, no Ajv at run time (a devDependency, for the
@@ -36,7 +36,7 @@ execution state and card fields name.
 | `./connect` | `ConnectTarget`, `ConnectLlm`, `ConnectHarness`, `ConnectExecutor`, `ConnectOpKind`, `ConnectProjectStatus`, `ConnectStoryStatus`, `ConnectPipelineState`, `ConnectWaitReason`, `ConnectProjectBranding` / `ConnectProjectBrandingSave` / `ConnectProjectBrandingFields` / `ConnectBrandingCredit` / `ConnectBrandingCreditBody`, the configuration contract (`ConnectScopeQuery`, `ConnectConfigScope`, `ConnectProjectConfig`, `ConnectConfigVariable`, `ConnectFrontendVariable`, `ConnectConfigValue`, `ConnectConfigSaveBody`, `CONNECT_CONFIG_*`), the organization's defaults (`ConnectOrganizationBranding(Save)`, `ConnectBrandingBackfill`), the planning-kit views (`PlanningKitView`, `ConnectKitDescribe`, `ConnectKitApplyBody`, `ConnectKitApplyResult` and their `*Schema`s), `ModelTier` + `modelTierHelper` (`tierOfRole`/`clampTier`), `ModelTask*`, `InquiryPayload` + `ConnectInquiryKind`, the session and domain-status views, the convert bodies (`ConnectConvertCreateBody`, `ConnectConvertStartBody`, `ConnectConvertProceedBody` + `ConnectConvertProceedUpdate`), `ConnectAgentLock`, `ConnectPaidGate` + `ConnectGateRef` + `ConnectEntrypointOptions`, the call collection (`CONNECT_CALL_HEADER`, `CONNECT_CALL_ACCEPT_MS`, `CONNECT_CALL_COLLECT_WAIT_SEC`, `CONNECT_CALL_LOST_MS`, `ConnectCallState`, `ConnectCallPending`, `ConnectCallResult`, `ConnectCallCollectParams` / `ConnectCallCollectQuery` and their `*Schema`s), the `Connect*` error family with `ConnectConfirmation` / `ConnectConfirmationAction`, `connectProtocols(opts)` and every `*Schema` behind them |
 | `./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) |
+| `./intent` | `intent` (the five aliases), `makeIntentProtocols(opts?)`, `intentFlow` + `IntentFlowStep` + `INTENT_PAYLOAD_REF`, `IntentStashBodySchema` / `IntentPickupBodySchema`, the `INTENT_*` constants (`INTENT_IMPORT_PATH`, `INTENT_IMPORT_KIND` included), `IntentDraft` / `IntentImportDraft`, `IntentExpired` (404) / `IntentThrottled` (429) |
 | `./iam-console` | The owner console's IAM contract both doors share (the browser's `back.iam`, the connector's `connect.iam`): the route params (`IamProjectParams`, `IamProjectUserParams`, `IamOrganizationParams`, `IamMemberParams`, `IamGroupParams`), `IamScoped`, the bodies (`IamDefinitionUpdate`, `IamStaffSync`, `IamAssignGrant` / `IamRevokeGrant`, `IamGrantsQuery`, `IamProjectUserInvite` / `Update`, `IamOrganizationEdit`, `IamProjectMemberInvite` / `Update`, `IamGroupCreate` / `Edit`, `IamGroupMembersChange`), the answers (`IamListResponse` + `external`, `IamUsersResponse`, `IamPermissionsResponse` + `IamTenancy`, …, `IamStaffSyncResponse`), every `Iam*Schema` (with `IamScopedSchema`, `IamGroupRefSchema`), `IAM_REFUSED`, and the `@owlmeans/iam` vocabulary re-exported (`IamDefaultClass`, `IamGrantMode`, `IamGrantOrigin`, `IamRemovalPolicy`, `IAM_AREAS`, `IAM_MEMBERS_GROUP`, the record types). The refusal's CLASS (`IamRefused`, 409) is the platform's |
 | `./legal` | `OWLMEANS_LEGAL_DATES`, `LegalDocumentDates`, `PendingLegalDocumentDates`, `LegalDocumentDateMetadata`, `LegalDocumentKey` — active dates and pending metadata for public legal sources and acceptance |
 
@@ -412,10 +412,11 @@ platform through this subpath: the site, the API services (stash and pickup may
 different ones) and the manager web agree on every address, schema and step. Platform side:
 `/intent-first`.
 
-- **Two guest routes and one screen, no guard, no gate, no service.** `stash` POST
+- **Two guest routes and two screens, no guard, no gate, no service.** `stash` POST
   `/public/intent` (`{ prompt 1..INTENT_PROMPT_MAX (8192), consent: const true }` →
   `{ ref, expiresAt }`), `pickup` POST `/public/intent/pickup` (`{ ref }`, exactly
-  `INTENT_REF_LENGTH` (24) Base58 → `{ prompt }`), `landing` (`frontend()` at `/start`, `sticky`).
+  `INTENT_REF_LENGTH` (24) Base58 → `{ prompt }`), `landing` (`frontend()` at `/start`, `sticky`) and
+  `importLanding` (`frontend()` at `INTENT_IMPORT_PATH` = `/start/import`, `sticky`).
   Mount the tree OUTSIDE any guarded parent (a route inherits every ancestor's guard) and fill
   `service` yourself (the site binds `landing` with `{ routeOptions: { overrides: { service } } }`,
   which also makes its `url()` absolute).
@@ -429,9 +430,17 @@ different ones) and the manager web agree on every address, schema and step. Pla
   parses it on every page load) and never `?intent=` (the login surrogate window owns it).
 - **CORS is not declared here**: the routes ride the global `origin: '*'` (no credentials);
   `makeIntentProtocols` carries a `TODO(cors)` naming the origins to keep if that is restricted.
-- **The browser draft is IndexedDB, per origin.** `IntentDraft` (`id`, `ref`, `prompt`,
-  `expiresAt`) is kept by the platform's browser between pickup and decision
-  (`INTENT_DRAFT_TTL_MS`, 24 h, checked on read).
+- **The second intent — import an existing project — is a plain link, no stash.** The visitor
+  brings no text, so the site links straight to `importLanding` (its absolute URL is
+  `new URL(INTENT_IMPORT_PATH, <platform web>)`); nothing crosses but the consent linker's `owlcc`.
+  `intentFlow` is not walked for it: its `land` step is `/start`, and the import landing needs only
+  the way on after sign-in, which is `HOME` for both.
+- **The browser draft is IndexedDB, per origin — ONE record slot for both intents.** `IntentDraft`
+  (`id`, `ref`, `prompt`, `expiresAt`) is kept between pickup and decision (`INTENT_DRAFT_TTL_MS`,
+  24 h); `IntentImportDraft` (`id`, `kind: INTENT_IMPORT_KIND`, `expiresAt`) holds the import wish
+  for `INTENT_SUSPEND_TTL_MS` (30 min — the sign-in it rides through). The newest intent replaces the
+  other; a record is an import iff its `kind` says so (a prompt draft carries none). Expiry is
+  checked on read.
 
 ## Slot metadata keys: optional means omitted
 

package/build/intent/consts.d.ts

@@ -18,10 +18,20 @@ export declare const intent: Readonly<{
     readonly stash: 'viable:manager-api:intent:stash';
     readonly pickup: 'viable:manager-api:intent:pickup';
     readonly landing: 'viable:manager-web:intent:landing';
+    readonly importLanding: 'viable:manager-web:intent:import';
 }>;
 /** Where the guest API lives, and the screen the visitor's browser is sent to. */
 export declare const INTENT_API_PATH = "/public/intent";
 export declare const INTENT_LANDING_PATH = "/start";
+/**
+ * The second way in: the public site's "Import from GitHub" is a plain link to this screen. There
+ * is nothing to stash — the visitor brings no text, only the wish — so no guest API call and no
+ * reference; the platform records the wish in the visitor's browser and opens its import dialog on
+ * the home screen once they are signed in.
+ */
+export declare const INTENT_IMPORT_PATH = "/start/import";
+/** `kind` of the browser record an import wish waits in ({@link IntentImportDraft}). */
+export declare const INTENT_IMPORT_KIND = "import";
 /** The flow the two sides walk. */
 export declare const INTENT_FLOW = "viable:intent";
 /**
@@ -42,7 +52,10 @@ export declare const INTENT_REF_PATTERN = "^[1-9A-HJ-NP-Za-km-z]{24}$";
 export declare const INTENT_PAYLOAD_REF = "ref";
 /** How long the visitor's draft survives in their own browser waiting for a decision. */
 export declare const INTENT_DRAFT_TTL_MS: number;
-/** How long a suspended landing waits while the visitor signs in or registers. */
+/**
+ * How long a suspended landing waits while the visitor signs in or registers — and how long an
+ * import wish waits in the browser: it belongs to that sign-in, not to a later visit.
+ */
 export declare const INTENT_SUSPEND_TTL_MS: number;
 /** Steps of {@link intentFlow}, exported so a screen never spells one as a literal. */
 export declare enum IntentFlowStep {

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

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/intent/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,2FAA2F;AAC3F,eAAO,MAAM,MAAM;mBACX,gCAAgC;oBAC/B,iCAAiC;qBAChC,kCAAkC;sBACjC,mCAAmC;EACnC,CAAA;AAEX,kFAAkF;AAClF,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAC/C,eAAO,MAAM,mBAAmB,WAAW,CAAA;AAE3C,mCAAmC;AACnC,eAAO,MAAM,WAAW,kBAAkB,CAAA;AAE1C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAErC,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAErC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAA;AACnC,eAAO,MAAM,kBAAkB,+BAA+B,CAAA;AAE9D,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,QAAQ,CAAA;AAEvC,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,QAAsB,CAAA;AAEtD,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,QAAiB,CAAA;AAEnD,uFAAuF;AACvF,oBAAY,cAAc;IACxB,wDAAwD;IACxD,OAAO,YAAY;IACnB,6DAA6D;IAC7D,IAAI,SAAS;IACb,6CAA6C;IAC7C,MAAM,YAAY;IAClB,mEAAmE;IACnE,MAAM,WAAW;CAClB;AAID;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,EAAE,WA6CxB,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/intent/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,2FAA2F;AAC3F,eAAO,MAAM,MAAM;mBACX,gCAAgC;oBAC/B,iCAAiC;qBAChC,kCAAkC;sBACjC,mCAAmC;4BAC7B,kCAAkC;EACxC,CAAA;AAEX,kFAAkF;AAClF,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAC/C,eAAO,MAAM,mBAAmB,WAAW,CAAA;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AAEjD,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAE1C,mCAAmC;AACnC,eAAO,MAAM,WAAW,kBAAkB,CAAA;AAE1C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAErC,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAErC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAA;AACnC,eAAO,MAAM,kBAAkB,+BAA+B,CAAA;AAE9D,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,QAAQ,CAAA;AAEvC,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,QAAsB,CAAA;AAEtD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAiB,CAAA;AAEnD,uFAAuF;AACvF,oBAAY,cAAc;IACxB,wDAAwD;IACxD,OAAO,YAAY;IACnB,6DAA6D;IAC7D,IAAI,SAAS;IACb,6CAA6C;IAC7C,MAAM,YAAY;IAClB,mEAAmE;IACnE,MAAM,WAAW;CAClB;AAID;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,EAAE,WA6CxB,CAAA"}

package/build/intent/consts.js

@@ -19,10 +19,20 @@ export const intent = Object.freeze({
     stash: 'viable:manager-api:intent:stash',
     pickup: 'viable:manager-api:intent:pickup',
     landing: 'viable:manager-web:intent:landing',
+    importLanding: 'viable:manager-web:intent:import',
 });
 /** Where the guest API lives, and the screen the visitor's browser is sent to. */
 export const INTENT_API_PATH = '/public/intent';
 export const INTENT_LANDING_PATH = '/start';
+/**
+ * The second way in: the public site's "Import from GitHub" is a plain link to this screen. There
+ * is nothing to stash — the visitor brings no text, only the wish — so no guest API call and no
+ * reference; the platform records the wish in the visitor's browser and opens its import dialog on
+ * the home screen once they are signed in.
+ */
+export const INTENT_IMPORT_PATH = '/start/import';
+/** `kind` of the browser record an import wish waits in ({@link IntentImportDraft}). */
+export const INTENT_IMPORT_KIND = 'import';
 /** The flow the two sides walk. */
 export const INTENT_FLOW = 'viable:intent';
 /**
@@ -43,7 +53,10 @@ export const INTENT_REF_PATTERN = '^[1-9A-HJ-NP-Za-km-z]{24}$';
 export const INTENT_PAYLOAD_REF = 'ref';
 /** How long the visitor's draft survives in their own browser waiting for a decision. */
 export const INTENT_DRAFT_TTL_MS = 24 * 60 * 60 * 1000;
-/** How long a suspended landing waits while the visitor signs in or registers. */
+/**
+ * How long a suspended landing waits while the visitor signs in or registers — and how long an
+ * import wish waits in the browser: it belongs to that sign-in, not to a later visit.
+ */
 export const INTENT_SUSPEND_TTL_MS = 30 * 60 * 1000;
 /** Steps of {@link intentFlow}, exported so a screen never spells one as a literal. */
 export var IntentFlowStep;

package/build/intent/consts.js.map

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

package/build/intent/entrypoints.d.ts

@@ -1,6 +1,7 @@
 import type { IntentProtocolOptions, IntentProtocols } from './types.js';
 /**
- * Declare the intent-first hand-off: two GUEST API routes and the landing screen's address.
+ * Declare the intent-first hand-off: two GUEST API routes and the two landing screens' addresses —
+ * `/start` for a stashed prompt, `/start/import` for the wish to import an existing project.
  *
  * No guard and no gate anywhere on the API — the caller is a visitor who has no account yet — and
  * no `service` on any route: each consumer fills it in (the public site names the platform's
@@ -10,7 +11,7 @@ import type { IntentProtocolOptions, IntentProtocols } from './types.js';
  * If viable ever restricts allowed origins globally, this entrypoint must keep answering the public
  * site's origins — owlmeans.com, owlmeans.pl and, in dev/stage, `http://localhost:4321`.
  *
- * The landing screen is `sticky`, like the OAuth consent screens: it is an ordinary in-app screen
+ * The landing screens are `sticky`, like the OAuth consent screens: it is an ordinary in-app screen
  * that a visitor arrives at directly from another origin.
  */
 export declare const makeIntentProtocols: (opts?: IntentProtocolOptions) => IntentProtocols;

package/build/intent/entrypoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../../src/intent/entrypoints.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAC4B,qBAAqB,EAAE,eAAe,EAC7E,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,UAAU,qBAAqB,KAAQ,eAkBtE,CAAA"}
+{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../../src/intent/entrypoints.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAC4B,qBAAqB,EAAE,eAAe,EAC7E,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,UAAU,qBAAqB,KAAQ,eAsBtE,CAAA"}

package/build/intent/entrypoints.js

@@ -1,9 +1,10 @@
 import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint';
 import { frontend, route, RouteMethod } from '@owlmeans/route';
-import { INTENT_API_PATH, INTENT_LANDING_PATH, intent } from './consts.js';
+import { INTENT_API_PATH, INTENT_IMPORT_PATH, INTENT_LANDING_PATH, intent } from './consts.js';
 import { IntentPickupBodySchema, IntentStashBodySchema } from './schemas.js';
 /**
- * Declare the intent-first hand-off: two GUEST API routes and the landing screen's address.
+ * Declare the intent-first hand-off: two GUEST API routes and the two landing screens' addresses —
+ * `/start` for a stashed prompt, `/start/import` for the wish to import an existing project.
  *
  * No guard and no gate anywhere on the API — the caller is a visitor who has no account yet — and
  * no `service` on any route: each consumer fills it in (the public site names the platform's
@@ -13,7 +14,7 @@ import { IntentPickupBodySchema, IntentStashBodySchema } from './schemas.js';
  * If viable ever restricts allowed origins globally, this entrypoint must keep answering the public
  * site's origins — owlmeans.com, owlmeans.pl and, in dev/stage, `http://localhost:4321`.
  *
- * The landing screen is `sticky`, like the OAuth consent screens: it is an ordinary in-app screen
+ * The landing screens are `sticky`, like the OAuth consent screens: it is an ordinary in-app screen
  * that a visitor arrives at directly from another origin.
  */
 export const makeIntentProtocols = (opts = {}) => {
@@ -23,6 +24,7 @@ export const makeIntentProtocols = (opts = {}) => {
         stash: protocol(route(intent.stash, '/', { parent: base, method: RouteMethod.POST }), contract.request({ body: typed(IntentStashBodySchema) }, typed())),
         pickup: protocol(route(intent.pickup, '/pickup', { parent: base, method: RouteMethod.POST }), contract.request({ body: typed(IntentPickupBodySchema) }, typed())),
         landing: openProtocol(route(intent.landing, opts.landing ?? INTENT_LANDING_PATH, frontend()), { sticky: true }),
+        importLanding: openProtocol(route(intent.importLanding, opts.importLanding ?? INTENT_IMPORT_PATH, frontend()), { sticky: true }),
     };
 };
 //# sourceMappingURL=entrypoints.js.map

package/build/intent/entrypoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../../src/intent/entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAK5E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAI,GAA0B,EAAE,EAAmB,EAAE;IACvF,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC,CAAC,CAAA;IAE3E,OAAO;QACL,IAAI;QAEJ,KAAK,EAAE,QAAQ,CACb,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,EACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAkB,qBAAqB,CAAC,EAAE,EAAE,KAAK,EAAqB,CAAC,CACtG;QAED,MAAM,EAAE,QAAQ,CACd,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,EAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAmB,sBAAsB,CAAC,EAAE,EAAE,KAAK,EAAsB,CAAC,CACzG;QAED,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAChH,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../../src/intent/entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC9F,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAK5E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAI,GAA0B,EAAE,EAAmB,EAAE;IACvF,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC,CAAC,CAAA;IAE3E,OAAO;QACL,IAAI;QAEJ,KAAK,EAAE,QAAQ,CACb,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,EACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAkB,qBAAqB,CAAC,EAAE,EAAE,KAAK,EAAqB,CAAC,CACtG;QAED,MAAM,EAAE,QAAQ,CACd,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,EAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAmB,sBAAsB,CAAC,EAAE,EAAE,KAAK,EAAsB,CAAC,CACzG;QAED,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAE/G,aAAa,EAAE,YAAY,CACzB,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,kBAAkB,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CACpG;KACF,CAAA;AACH,CAAC,CAAA"}

package/build/intent/types.d.ts

@@ -1,5 +1,6 @@
 import type { EntrypointProtocol, OpenRequest, OpenValue } from '@owlmeans/entrypoint';
 import type { ResourceRecord } from '@owlmeans/resource';
+import type { INTENT_IMPORT_KIND } from './consts.js';
 /** What the public site sends: the prompt and the person's confirmation of its processing. */
 export interface IntentStashBody {
     prompt: string;
@@ -29,6 +30,16 @@ export interface IntentDraft extends ResourceRecord {
     prompt: string;
     expiresAt: number;
 }
+/**
+ * The wish to import an existing project, waiting in the visitor's browser between the import
+ * landing and the home screen. It shares {@link IntentDraft}'s record slot, so the visitor's NEWEST
+ * intent is the one acted on; `kind` tells the two apart (a prompt draft carries none).
+ */
+export interface IntentImportDraft extends ResourceRecord {
+    id: string;
+    kind: typeof INTENT_IMPORT_KIND;
+    expiresAt: number;
+}
 /**
  * Options of {@link makeIntentProtocols}.
  */
@@ -37,6 +48,8 @@ export interface IntentProtocolOptions {
     path?: string;
     /** Path of the landing screen; defaults to `/start`. */
     landing?: string;
+    /** Path of the import landing screen; defaults to `/start/import`. */
+    importLanding?: string;
 }
 /** The intent-first hand-off tree {@link makeIntentProtocols} declares. */
 export interface IntentProtocols {
@@ -49,5 +62,7 @@ export interface IntentProtocols {
     }, IntentPickupResult>;
     /** The landing screen — `sticky`, an in-app screen a visitor reaches from another origin. */
     landing: EntrypointProtocol<OpenRequest, OpenValue>;
+    /** The import landing screen — `sticky` too; reached by a plain link, no stash. */
+    importLanding: EntrypointProtocol<OpenRequest, OpenValue>;
 }
 //# sourceMappingURL=types.d.ts.map

package/build/intent/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,0FAA0F;IAC1F,OAAO,EAAE,IAAI,CAAA;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,EAAE,EAAE,MAAM,CAAA;IACV,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAChD,KAAK,EAAE,kBAAkB,CAAC;QAAE,IAAI,EAAE,eAAe,CAAA;KAAE,EAAE,iBAAiB,CAAC,CAAA;IACvE,MAAM,EAAE,kBAAkB,CAAC;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,EAAE,kBAAkB,CAAC,CAAA;IAC1E,6FAA6F;IAC7F,OAAO,EAAE,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;CACpD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,0FAA0F;IAC1F,OAAO,EAAE,IAAI,CAAA;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,EAAE,EAAE,MAAM,CAAA;IACV,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,OAAO,kBAAkB,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAChD,KAAK,EAAE,kBAAkB,CAAC;QAAE,IAAI,EAAE,eAAe,CAAA;KAAE,EAAE,iBAAiB,CAAC,CAAA;IACvE,MAAM,EAAE,kBAAkB,CAAC;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,EAAE,kBAAkB,CAAC,CAAA;IAC1E,6FAA6F;IAC7F,OAAO,EAAE,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IACnD,mFAAmF;IACnF,aAAa,EAAE,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;CAC1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/viable-common",
-  "version": "0.0.48-rc.2",
+  "version": "0.0.48-rc.4",
   "license": "MIT",
   "description": "Runtime-free contracts of the OwlMeans Viable platform — the analysis, design and metadata shapes of a generated project, its target-shape manifest, the slot command vocabulary, the connector protocol, the owner console's IAM contract and the conversion vocabulary, and the intent-first hand-off from the public site to the platform.",
   "type": "module",
@@ -82,14 +82,14 @@
   "dependencies": {
     "@owlmeans/agent-common": "^0.1.18-rc.49",
     "@owlmeans/auth": "^0.1.18-rc.41",
-    "@owlmeans/auth-common": "^0.1.18-rc.50",
+    "@owlmeans/auth-common": "^0.1.18-rc.51",
     "@owlmeans/context": "^0.1.18-rc.34",
     "@owlmeans/entrypoint": "^0.1.18-rc.41",
     "@owlmeans/error": "^0.1.18-rc.38",
     "@owlmeans/flow": "^0.1.18-rc.45",
-    "@owlmeans/iam": "^0.1.18-rc.53",
+    "@owlmeans/iam": "^0.1.18-rc.54",
     "@owlmeans/llm-common": "^0.1.18-rc.39",
-    "@owlmeans/planning": "^0.1.18-rc.27",
+    "@owlmeans/planning": "^0.1.18-rc.28",
     "@owlmeans/resource": "^0.1.18-rc.40",
     "@owlmeans/route": "^0.1.18-rc.35"
   },

package/src/intent/consts.ts

@@ -22,12 +22,24 @@ export const intent = Object.freeze({
   stash: 'viable:manager-api:intent:stash',
   pickup: 'viable:manager-api:intent:pickup',
   landing: 'viable:manager-web:intent:landing',
+  importLanding: 'viable:manager-web:intent:import',
 } as const)
 
 /** Where the guest API lives, and the screen the visitor's browser is sent to. */
 export const INTENT_API_PATH = '/public/intent'
 export const INTENT_LANDING_PATH = '/start'
 
+/**
+ * The second way in: the public site's "Import from GitHub" is a plain link to this screen. There
+ * is nothing to stash — the visitor brings no text, only the wish — so no guest API call and no
+ * reference; the platform records the wish in the visitor's browser and opens its import dialog on
+ * the home screen once they are signed in.
+ */
+export const INTENT_IMPORT_PATH = '/start/import'
+
+/** `kind` of the browser record an import wish waits in ({@link IntentImportDraft}). */
+export const INTENT_IMPORT_KIND = 'import'
+
 /** The flow the two sides walk. */
 export const INTENT_FLOW = 'viable:intent'
 
@@ -54,7 +66,10 @@ export const INTENT_PAYLOAD_REF = 'ref'
 /** How long the visitor's draft survives in their own browser waiting for a decision. */
 export const INTENT_DRAFT_TTL_MS = 24 * 60 * 60 * 1000
 
-/** How long a suspended landing waits while the visitor signs in or registers. */
+/**
+ * How long a suspended landing waits while the visitor signs in or registers — and how long an
+ * import wish waits in the browser: it belongs to that sign-in, not to a later visit.
+ */
 export const INTENT_SUSPEND_TTL_MS = 30 * 60 * 1000
 
 /** Steps of {@link intentFlow}, exported so a screen never spells one as a literal. */

package/src/intent/entrypoints.ts

@@ -1,13 +1,14 @@
 import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint'
 import { frontend, route, RouteMethod } from '@owlmeans/route'
-import { INTENT_API_PATH, INTENT_LANDING_PATH, intent } from './consts.js'
+import { INTENT_API_PATH, INTENT_IMPORT_PATH, INTENT_LANDING_PATH, intent } from './consts.js'
 import { IntentPickupBodySchema, IntentStashBodySchema } from './schemas.js'
 import type {
   IntentPickupBody, IntentPickupResult, IntentProtocolOptions, IntentProtocols, IntentStashBody, IntentStashResult,
 } from './types.js'
 
 /**
- * Declare the intent-first hand-off: two GUEST API routes and the landing screen's address.
+ * Declare the intent-first hand-off: two GUEST API routes and the two landing screens' addresses —
+ * `/start` for a stashed prompt, `/start/import` for the wish to import an existing project.
  *
  * No guard and no gate anywhere on the API — the caller is a visitor who has no account yet — and
  * no `service` on any route: each consumer fills it in (the public site names the platform's
@@ -17,7 +18,7 @@ import type {
  * If viable ever restricts allowed origins globally, this entrypoint must keep answering the public
  * site's origins — owlmeans.com, owlmeans.pl and, in dev/stage, `http://localhost:4321`.
  *
- * The landing screen is `sticky`, like the OAuth consent screens: it is an ordinary in-app screen
+ * The landing screens are `sticky`, like the OAuth consent screens: it is an ordinary in-app screen
  * that a visitor arrives at directly from another origin.
  */
 export const makeIntentProtocols = (opts: IntentProtocolOptions = {}): IntentProtocols => {
@@ -37,6 +38,10 @@ export const makeIntentProtocols = (opts: IntentProtocolOptions = {}): IntentPro
     ),
 
     landing: openProtocol(route(intent.landing, opts.landing ?? INTENT_LANDING_PATH, frontend()), { sticky: true }),
+
+    importLanding: openProtocol(
+      route(intent.importLanding, opts.importLanding ?? INTENT_IMPORT_PATH, frontend()), { sticky: true },
+    ),
   }
 }
 

package/src/intent/types.ts

@@ -1,5 +1,6 @@
 import type { EntrypointProtocol, OpenRequest, OpenValue } from '@owlmeans/entrypoint'
 import type { ResourceRecord } from '@owlmeans/resource'
+import type { INTENT_IMPORT_KIND } from './consts.js'
 
 /** What the public site sends: the prompt and the person's confirmation of its processing. */
 export interface IntentStashBody {
@@ -35,6 +36,17 @@ export interface IntentDraft extends ResourceRecord {
   expiresAt: number
 }
 
+/**
+ * The wish to import an existing project, waiting in the visitor's browser between the import
+ * landing and the home screen. It shares {@link IntentDraft}'s record slot, so the visitor's NEWEST
+ * intent is the one acted on; `kind` tells the two apart (a prompt draft carries none).
+ */
+export interface IntentImportDraft extends ResourceRecord {
+  id: string
+  kind: typeof INTENT_IMPORT_KIND
+  expiresAt: number
+}
+
 /**
  * Options of {@link makeIntentProtocols}.
  */
@@ -43,6 +55,8 @@ export interface IntentProtocolOptions {
   path?: string
   /** Path of the landing screen; defaults to `/start`. */
   landing?: string
+  /** Path of the import landing screen; defaults to `/start/import`. */
+  importLanding?: string
 }
 
 /** The intent-first hand-off tree {@link makeIntentProtocols} declares. */
@@ -52,4 +66,6 @@ export interface IntentProtocols {
   pickup: EntrypointProtocol<{ body: IntentPickupBody }, IntentPickupResult>
   /** The landing screen — `sticky`, an in-app screen a visitor reaches from another origin. */
   landing: EntrypointProtocol<OpenRequest, OpenValue>
+  /** The import landing screen — `sticky` too; reached by a plain link, no stash. */
+  importLanding: EntrypointProtocol<OpenRequest, OpenValue>
 }

package/tests/intent.spec.ts

@@ -8,7 +8,7 @@ import { makeFlowModel } from '@owlmeans/flow'
 import { AppType } from '@owlmeans/context'
 import { RouteMethod } from '@owlmeans/route'
 import {
-  INTENT_PAYLOAD_REF, INTENT_PROMPT_MAX, INTENT_TTL_SECONDS, IntentExpired, IntentFlowStep,
+  INTENT_IMPORT_PATH, INTENT_PAYLOAD_REF, INTENT_PROMPT_MAX, INTENT_TTL_SECONDS, IntentExpired, IntentFlowStep,
   IntentPickupBodySchema, IntentStashBodySchema, IntentThrottled, intent, intentFlow, makeIntentProtocols,
 } from '../src/intent/index.js'
 
@@ -24,13 +24,14 @@ const createIdOfLength = (length: number): string =>
 describe('@owlmeans/viable-common — intent-first hand-off', () => {
   const tree = makeIntentProtocols()
 
-  test('declares one guest base, two guest routes and a landing screen — no guard, no gate, no service', () => {
+  test('declares one guest base, two guest routes and two landing screens — no guard, no gate, no service', () => {
     expect(tree.base.alias).toBe(intent.base)
     expect(tree.stash.alias).toBe(intent.stash)
     expect(tree.pickup.alias).toBe(intent.pickup)
     expect(tree.landing.alias).toBe(intent.landing)
-    expect(new Set(protocols(tree).map(protocol => protocol.alias)).size).toBe(4)
-    for (const declaration of [tree.base, tree.stash, tree.pickup, tree.landing]) {
+    expect(tree.importLanding.alias).toBe(intent.importLanding)
+    expect(new Set(protocols(tree).map(protocol => protocol.alias)).size).toBe(5)
+    for (const declaration of [tree.base, tree.stash, tree.pickup, tree.landing, tree.importLanding]) {
       expect(declaration.guards ?? []).toEqual([])
       expect(declaration.gate).toBeUndefined()
       expect(declaration.route.route.service).toBeUndefined()
@@ -40,6 +41,9 @@ describe('@owlmeans/viable-common — intent-first hand-off', () => {
     expect(tree.pickup.route.route.path).toBe('/pickup')
     expect(tree.landing.route.route.path).toBe('/start')
     expect(tree.landing.route.route.type).toBe(AppType.Frontend)
+    expect(tree.importLanding.route.route.path).toBe(INTENT_IMPORT_PATH)
+    expect(tree.importLanding.route.route.type).toBe(AppType.Frontend)
+    expect(tree.importLanding.route.route.parent).toBeUndefined()
     expect(aliasOf(tree.stash)).toBe(intent.stash)
   })