@hasna/skills 0.2.1 → 0.3.0

package/dist/sdk/runs.d.ts

@@ -38,7 +38,23 @@ export declare const runAdmissionSchema: z.ZodObject<{
     skill: z.ZodString;
     status: z.ZodLiteral<"admitted">;
     createdAt: z.ZodString;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    status: "admitted";
+    createdAt: string;
+    skill: string;
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+}, {
+    status: "admitted";
+    createdAt: string;
+    skill: string;
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+}>;
 export type RunAdmission = z.infer<typeof runAdmissionSchema>;
 /** Lease: a worker has claimed the run. */
 export declare const runLeaseSchema: z.ZodObject<{
@@ -48,7 +64,21 @@ export declare const runLeaseSchema: z.ZodObject<{
     leaseGeneration: z.ZodNumber;
     workerId: z.ZodString;
     status: z.ZodLiteral<"leased">;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    status: "leased";
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+    workerId: string;
+}, {
+    status: "leased";
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+    workerId: string;
+}>;
 export type RunLease = z.infer<typeof runLeaseSchema>;
 /** Terminal: the run reached a final state. */
 export declare const runTerminalSchema: z.ZodObject<{
@@ -57,17 +87,28 @@ export declare const runTerminalSchema: z.ZodObject<{
     attemptId: z.ZodString;
     leaseGeneration: z.ZodNumber;
     skill: z.ZodString;
-    status: z.ZodEnum<{
-        cancelled: "cancelled";
-        failed: "failed";
-        succeeded: "succeeded";
-        expired: "expired";
-    }>;
+    status: z.ZodEnum<["succeeded", "failed", "cancelled", "expired"]>;
     completedAt: z.ZodString;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    status: "cancelled" | "failed" | "succeeded" | "expired";
+    skill: string;
+    completedAt: string;
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+}, {
+    status: "cancelled" | "failed" | "succeeded" | "expired";
+    skill: string;
+    completedAt: string;
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+}>;
 export type RunTerminal = z.infer<typeof runTerminalSchema>;
 /** Any single protocol message, discriminated by `status`. */
-export declare const runProtocolSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const runProtocolSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
     contractVersion: z.ZodLiteral<1>;
     runId: z.ZodString;
     attemptId: z.ZodString;
@@ -75,27 +116,68 @@ export declare const runProtocolSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     skill: z.ZodString;
     status: z.ZodLiteral<"admitted">;
     createdAt: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
+}, "strip", z.ZodTypeAny, {
+    status: "admitted";
+    createdAt: string;
+    skill: string;
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+}, {
+    status: "admitted";
+    createdAt: string;
+    skill: string;
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+}>, z.ZodObject<{
     contractVersion: z.ZodLiteral<1>;
     runId: z.ZodString;
     attemptId: z.ZodString;
     leaseGeneration: z.ZodNumber;
     workerId: z.ZodString;
     status: z.ZodLiteral<"leased">;
-}, z.core.$strip>, z.ZodObject<{
+}, "strip", z.ZodTypeAny, {
+    status: "leased";
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+    workerId: string;
+}, {
+    status: "leased";
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+    workerId: string;
+}>, z.ZodObject<{
     contractVersion: z.ZodLiteral<1>;
     runId: z.ZodString;
     attemptId: z.ZodString;
     leaseGeneration: z.ZodNumber;
     skill: z.ZodString;
-    status: z.ZodEnum<{
-        cancelled: "cancelled";
-        failed: "failed";
-        succeeded: "succeeded";
-        expired: "expired";
-    }>;
+    status: z.ZodEnum<["succeeded", "failed", "cancelled", "expired"]>;
     completedAt: z.ZodString;
-}, z.core.$strip>], "status">;
+}, "strip", z.ZodTypeAny, {
+    status: "cancelled" | "failed" | "succeeded" | "expired";
+    skill: string;
+    completedAt: string;
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+}, {
+    status: "cancelled" | "failed" | "succeeded" | "expired";
+    skill: string;
+    completedAt: string;
+    contractVersion: 1;
+    runId: string;
+    leaseGeneration: number;
+    attemptId: string;
+}>]>;
 export type RunProtocolMessage = z.infer<typeof runProtocolSchema>;
 /** Map the store's status vocabulary onto the protocol lifecycle. */
 export declare function protocolStateOf(status: ServerRunStatus): RunProtocolState;

package/dist/storage.js

@@ -65,7 +65,12 @@ import { join as join2, dirname } from "path";
 // src/lib/retired-settings.ts
 var RETIRED_ENV_SUFFIXES = ["_STORAGE_MODE", "_DEPLOYMENT_MODE", "_CLOUD_MODE"];
 var RETIRED_CONFIG_KEYS = {
-  mode: "apiUrl"
+  mode: "a configured API origin",
+  apiUrl: "skills setup --api-url <origin>"
+};
+var RETIRED_CONFIG_KEY_REASONS = {
+  mode: "Deployment modes were removed: a Skills client either resolves a credential " + "or it does not, and that is the whole of it.",
+  apiUrl: "The service address is no longer kept in this app's config file: it is read from " + "HASNA_SKILLS_API_URL, then the macOS Keychain item hasna.credentials.skills.api-url, " + "then ~/.hasna/skills/config/credentials, then the fleet gateway."
 };
 
 class RetiredSettingError extends Error {
@@ -104,7 +109,7 @@ function assertNoRetiredConfigKeys(config, source) {
   for (const [key, replacement] of Object.entries(RETIRED_CONFIG_KEYS)) {
     if (!(key in config))
       continue;
-    throw new RetiredSettingError(key, `${source}: "${key}" is no longer a configuration key. ` + "Deployment modes were removed: a Skills client either has an API origin " + "configured or it does not, and that is the whole of it. " + `Use "${replacement}" instead (skills config set ${replacement} <origin>), and ` + `remove the old key with: skills config unset ${key}. ` + "Refused rather than ignored, because silently dropping it would leave an " + "operator believing they had pointed this install at a server.");
+    throw new RetiredSettingError(key, `${source}: "${key}" is no longer a configuration key. ` + `${RETIRED_CONFIG_KEY_REASONS[key] ?? ""} ` + `Use ${replacement} instead, and remove the old key with: skills config unset ${key}. ` + "Refused rather than ignored, because silently dropping it would leave an " + "operator believing they had pointed this install at a server.");
   }
 }
 
@@ -232,7 +237,7 @@ var ENUM_KEYS = {
   defaultScope: ["global", "project"],
   format: ["compact", "json", "csv"]
 };
-var STRING_KEYS = ["apiUrl", "extensionsDir"];
+var STRING_KEYS = ["extensionsDir"];
 function validKeys() {
   return [...Object.keys(ENUM_KEYS), ...STRING_KEYS];
 }
@@ -263,16 +268,6 @@ function normalizeConfigValue(key, value) {
   const allowed = allowedValues(key);
   if (allowed)
     return allowed.includes(value) ? value : undefined;
-  if (key === "apiUrl") {
-    try {
-      const url = new URL(value);
-      if (url.protocol !== "http:" && url.protocol !== "https:")
-        return;
-      return value.replace(/\/+$/, "");
-    } catch {
-      return;
-    }
-  }
   if (key === "extensionsDir")
     return value.trim() ? value : undefined;
   return;
@@ -342,7 +337,7 @@ function saveConfig(key, value, scope = "project") {
   const normalized = normalizeConfigValue(key, value);
   if (normalized === undefined) {
     const allowed = allowedValues(key);
-    throw new Error(allowed ? `Invalid value '${value}' for ${key}. Allowed: ${allowed.join(", ")}` : `Invalid value '${value}' for ${key}. Expected ${key === "apiUrl" ? "an http(s) URL" : "a non-empty path"}`);
+    throw new Error(allowed ? `Invalid value '${value}' for ${key}. Allowed: ${allowed.join(", ")}` : `Invalid value '${value}' for ${key}. Expected a non-empty path`);
   }
   const filePath = getConfigPath(scope);
   let existing = {};

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@hasna/skills",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {
     "skills": "bin/index.js",
     "skills-mcp": "bin/mcp.js",
+    "skills-serve": "bin/server.js",
     "skills-server": "bin/server.js",
     "skills-worker": "bin/worker.js",
     "skills-migrate": "bin/migrate.js"
@@ -91,6 +92,7 @@
   "dependencies": {
     "@aws-sdk/client-ecs": "^3.1079.0",
     "@aws-sdk/client-s3": "^3.1079.0",
+    "@hasna/contracts": "1.0.1",
     "@hasna/events": "0.1.16",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "chalk": "^5.3.0",