sh3-core 0.14.0 → 0.15.0

package/dist/shell-shard/toolbar/slots/BusySlot.svelte

@@ -0,0 +1,35 @@
+<script lang="ts">
+  interface Props {
+    active: boolean;
+    label: string | null;
+  }
+  let { active, label }: Props = $props();
+</script>
+
+{#if active}
+  <div class="busy" role="status" aria-live="polite">
+    <span class="spinner" aria-hidden="true"></span>
+    {#if label}<span class="label">{label}</span>{/if}
+  </div>
+{/if}
+
+<style>
+  .busy {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    color: var(--shell-fg-muted, #aaa);
+    font-size: 0.85em;
+  }
+  .spinner {
+    width: 12px;
+    height: 12px;
+    border: 2px solid var(--shell-fg-muted, #aaa);
+    border-top-color: transparent;
+    border-radius: 50%;
+    animation: busy-spin 0.8s linear infinite;
+  }
+  @keyframes busy-spin {
+    to { transform: rotate(360deg); }
+  }
+</style>

package/dist/shell-shard/toolbar/slots/BusySlot.svelte.d.ts

@@ -0,0 +1,7 @@
+interface Props {
+    active: boolean;
+    label: string | null;
+}
+declare const BusySlot: import("svelte").Component<Props, {}, "">;
+type BusySlot = ReturnType<typeof BusySlot>;
+export default BusySlot;

package/dist/shell-shard/verbs/clear.js

@@ -1,6 +1,7 @@
 export const clearVerb = {
     name: 'clear',
     summary: 'Clear the scrollback (local only — other views are unaffected).',
+    globalVerb: true,
     async run(ctx) {
         ctx.scrollback.clear();
     },

package/dist/shell-shard/verbs/mode.js

@@ -1,6 +1,7 @@
 export const modeVerb = {
     name: 'mode',
     summary: 'List or switch shell modes. Usage: mode | mode <id>',
+    globalVerb: true,
     async run(ctx, args) {
         const ts = Date.now();
         if (args.length === 0) {

package/dist/verbs/types.d.ts

@@ -86,10 +86,78 @@ export interface VerbContext {
     fs: TenantFsClient;
     /** Invoke another registered verb programmatically (used by rich-entry clicks). */
     dispatch(line: string): Promise<void>;
+    /**
+     * When the verb was invoked via `ctx.runVerb(..., { structured })`,
+     * this holds the structured payload the caller passed. Terminal-driven
+     * invocations leave it undefined and the verb falls back to `args[]`.
+     * See `Verb.schema.input` for the JSON Schema describing the shape.
+     */
+    structuredArgs?: unknown;
+    /**
+     * When the verb was invoked via `ctx.runVerb(..., { signal })`, this
+     * carries the abort signal so cooperative verbs can honor cancellation.
+     * Terminal-driven invocations leave it undefined.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Portable JSON Schema subset accepted by sh3-core for `Verb.schema.input`.
+ * Documented as the intersection of what Anthropic, OpenAI, and Gemini
+ * tool-call APIs accept natively. sh3-core does NOT validate that the
+ * actual schema stays within this subset — authors who reach for `oneOf`,
+ * `$ref`, or other Draft 2020-12 features do so at their own portability
+ * risk. The type is intentionally `unknown`-permissive on `properties`
+ * and `items` so authors can express object/array shapes without
+ * fighting the type system.
+ */
+export interface PortableJSONSchema {
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
+    description?: string;
+    enum?: unknown[];
+    default?: unknown;
+    /** Object-shape property map (key → sub-schema). */
+    properties?: Record<string, PortableJSONSchema>;
+    /** Required property names for `type: 'object'`. */
+    required?: string[];
+    /** Item schema for `type: 'array'`. */
+    items?: PortableJSONSchema;
+}
+/**
+ * Optional schema attached to a verb. Today only `input` is consumed
+ * (by sh3-ai's tool-call dispatcher); `output` is deferred until
+ * sh3-editor's graph view materializes a real consumer.
+ */
+export interface VerbSchema {
+    input: PortableJSONSchema;
 }
 export interface Verb {
     name: string;
     summary: string;
+    /**
+     * When true, this verb resolves in every shell mode — including bash and
+     * external shards' custom modes. Defaults to false: sh3-domain verbs only
+     * resolve when `mode.id === 'sh3'`. Reserve this flag for verbs whose
+     * action is mode-agnostic (e.g. `clear` clears the local scrollback,
+     * `mode` switches modes — both make sense everywhere).
+     */
+    globalVerb?: boolean;
+    /**
+     * When true, this verb opts in to dispatch via `ctx.runVerb(...)`. By
+     * setting this flag the author commits to behaving correctly outside a
+     * real terminal frame — in particular, treating `ctx.scrollback` as a
+     * sink whose entries the caller may render later, and not depending on
+     * UI side-effects beyond what the synthesized context provides
+     * (no `ctx.session.connect()`, no terminal-mode switching, etc.).
+     * Defaults to false; `runVerb` rejects non-programmatic verbs.
+     */
+    programmatic?: boolean;
+    /**
+     * Optional input/output schema for typed callers. When present and the
+     * caller dispatches with `runVerb(..., { structured })`, the structured
+     * payload is delivered via `ctx.structuredArgs`; the verb chooses
+     * whether to read it or fall back to `args[]`.
+     */
+    schema?: VerbSchema;
     run(ctx: VerbContext, args: string[]): Promise<void>;
 }
 export type Resolution = {

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export declare const VERSION = "0.14.0";
+export declare const VERSION = "0.15.0";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export const VERSION = '0.14.0';
+export const VERSION = '0.15.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh3-core",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "type": "module",
   "files": [
     "dist"