@ikenga/contract 0.12.0 → 0.14.0

package/dist/browser.d.ts

@@ -531,13 +531,13 @@ export declare const BrowserWaitForInputSchema: z.ZodObject<{
     /** Default 10_000ms; clamped to [100, 60_000] by the server. */
     timeout_ms: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    id: string & z.BRAND<"BrowserPaneId">;
     kind: "url" | "ref" | "text" | "selector" | "gone-text" | "gone-selector" | "idle";
+    id: string & z.BRAND<"BrowserPaneId">;
     value?: string | undefined;
     timeout_ms?: number | undefined;
 }, {
-    id: string;
     kind: "url" | "ref" | "text" | "selector" | "gone-text" | "gone-selector" | "idle";
+    id: string;
     value?: string | undefined;
     timeout_ms?: number | undefined;
 }>;

package/dist/engine/adapter.d.ts

@@ -105,8 +105,8 @@ export declare const AgentCapabilitiesSchema: z.ZodObject<{
     /** Can resume a prior session by id. */
     sessionResume: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
-    mcp: boolean;
     streaming: boolean;
+    mcp: boolean;
     toolUse: boolean;
     thinking: boolean;
     artifacts: boolean;
@@ -118,8 +118,8 @@ export declare const AgentCapabilitiesSchema: z.ZodObject<{
     agenticTools: boolean;
     sessionResume: boolean;
 }, {
-    mcp: boolean;
     streaming: boolean;
+    mcp: boolean;
     toolUse: boolean;
     thinking: boolean;
     artifacts: boolean;
@@ -202,8 +202,8 @@ export declare const EngineProvidesSchema: z.ZodObject<{
         /** Can resume a prior session by id. */
         sessionResume: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        mcp: boolean;
         streaming: boolean;
+        mcp: boolean;
         toolUse: boolean;
         thinking: boolean;
         artifacts: boolean;
@@ -215,8 +215,8 @@ export declare const EngineProvidesSchema: z.ZodObject<{
         agenticTools: boolean;
         sessionResume: boolean;
     }, {
-        mcp: boolean;
         streaming: boolean;
+        mcp: boolean;
         toolUse: boolean;
         thinking: boolean;
         artifacts: boolean;
@@ -254,8 +254,8 @@ export declare const EngineProvidesSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     capabilities: {
-        mcp: boolean;
         streaming: boolean;
+        mcp: boolean;
         toolUse: boolean;
         thinking: boolean;
         artifacts: boolean;
@@ -277,8 +277,8 @@ export declare const EngineProvidesSchema: z.ZodObject<{
     display?: string | undefined;
 }, {
     capabilities: {
-        mcp: boolean;
         streaming: boolean;
+        mcp: boolean;
         toolUse: boolean;
         thinking: boolean;
         artifacts: boolean;

package/dist/host-context.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+/**
+ * Identity of the human operating the shell, injected into `hostContext` at
+ * the AppBridge handshake (`buildHostContext()` in
+ * `shell/src/lib/pkg/host-context.ts`, cast in alongside `royaltiSuite` /
+ * `supabase` / `secrets`). Host-injected, not pkg-declared — there is no
+ * manifest capability gate for it.
+ *
+ * Currently sourced from the free-text onboarding `userName` (shell store),
+ * falling back to the OS username when unset. Treat `id` as a stable
+ * display label, NOT a durable account id or an auth subject.
+ */
+export declare const OperatorIdentitySchema: z.ZodObject<{
+    /** Stable-enough identifier for the operator (today: `userName` or an
+     *  OS-username fallback). Not an auth subject. */
+    id: z.ZodString;
+    /** Human-friendly label, when it differs from `id`. */
+    displayName: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    displayName?: string | undefined;
+}, {
+    id: string;
+    displayName?: string | undefined;
+}>;
+export type OperatorIdentity = z.infer<typeof OperatorIdentitySchema>;
+/**
+ * hostContext fields Ikenga casts onto the MCP-UI-Apps `McpUiHostContext`
+ * base type (imported from `@modelcontextprotocol/ext-apps/app-bridge` —
+ * this package does not redefine that base type, only the Ikenga-specific
+ * extensions layered onto it).
+ *
+ * `operator` is OPTIONAL: older shells and the initial handshake before the
+ * onboarding step has run won't send it. A consumer MUST treat an absent
+ * `operator` as an UNKNOWN operator and fail SAFE — e.g. use a confirming
+ * `ux_mode` ('confirm') rather than auto-approving an operator-scoped
+ * action — never assume a default identity.
+ */
+export interface IkengaHostContextExtensions {
+    operator?: OperatorIdentity;
+}
+//# sourceMappingURL=host-context.d.ts.map

package/dist/host-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-context.d.ts","sourceRoot":"","sources":["../src/host-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB;IAE/B;sDACkD;;IAElD,uDAAuD;;;;;;;;EAGhD,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B"}

package/dist/host-context.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/**
+ * Identity of the human operating the shell, injected into `hostContext` at
+ * the AppBridge handshake (`buildHostContext()` in
+ * `shell/src/lib/pkg/host-context.ts`, cast in alongside `royaltiSuite` /
+ * `supabase` / `secrets`). Host-injected, not pkg-declared — there is no
+ * manifest capability gate for it.
+ *
+ * Currently sourced from the free-text onboarding `userName` (shell store),
+ * falling back to the OS username when unset. Treat `id` as a stable
+ * display label, NOT a durable account id or an auth subject.
+ */
+export const OperatorIdentitySchema = z
+    .object({
+    /** Stable-enough identifier for the operator (today: `userName` or an
+     *  OS-username fallback). Not an auth subject. */
+    id: z.string(),
+    /** Human-friendly label, when it differs from `id`. */
+    displayName: z.string().optional(),
+})
+    .strict();
+//# sourceMappingURL=host-context.js.map

package/dist/host-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-context.js","sourceRoot":"","sources":["../src/host-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN;sDACkD;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,uDAAuD;IACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export * from './registry.js';
 export * from './browser.js';
 export * from './pa-actions.js';
 export * from './window.js';
+export * from './action-frontmatter.js';
+export * from './host-context.js';
 /** This package's own version. */
 export declare const CONTRACT_PACKAGE_VERSION: "0.5.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAE5B,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAElC,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}

package/dist/index.js

@@ -9,6 +9,8 @@ export * from './registry.js';
 export * from './browser.js';
 export * from './pa-actions.js';
 export * from './window.js';
+export * from './action-frontmatter.js';
+export * from './host-context.js';
 /** This package's own version. */
 export const CONTRACT_PACKAGE_VERSION = '0.5.0';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAE5B,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAElC,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}