@phreshos/cli 0.1.69 → 0.1.71

package/dist/commands/access.js

@@ -6,6 +6,7 @@ import windowCommands from "./window.js";
 import executeCommand from "./execute.js";
 import operationCommands from "./operation.js";
 import serviceCommands from "./service.js";
+import systemCommands from "./system.js";
 /** Expose the shared System domains through explicit Node SDK executors. */
 export default function accessCommands(program, connect = connectSystem) {
     executeCommand(program, connect);
@@ -14,5 +15,6 @@ export default function accessCommands(program, connect = connectSystem) {
     processCommands(program, connect);
     endpointCommands(program, connect);
     serviceCommands(program, connect);
+    systemCommands(program, connect);
     windowCommands(program, connect);
 }

package/dist/commands/execution.js

@@ -3,6 +3,7 @@ import { describeExecuteOperation } from "@phreshos/core";
 export const executeCommandPaths = Object.freeze({
     "operation.list": ["operation", "list"],
     "operation.describe": ["operation", "describe"],
+    "system.logs": ["system", "logs"],
     "program.list": ["program", "list"],
     "program.find": ["program", "inspect"],
     "program.agent": ["program", "agent"],
@@ -18,7 +19,6 @@ export const executeCommandPaths = Object.freeze({
     "program.allowsPermission": ["program", "allowsPermission"],
     "program.allowPermission": ["program", "allowPermission"],
     "program.denyPermission": ["program", "denyPermission"],
-    "program.requestPermission": ["program", "requestPermission"],
     "program.logs": ["program", "logs"],
     "program.wait": ["program", "wait"],
     "process.list": ["process", "list"],
@@ -52,8 +52,6 @@ export const executeCommandPaths = Object.freeze({
     "window.maximize": ["window", "maximize"],
     "window.setTitle": ["window", "setTitle"],
     "window.setHeader": ["window", "setHeader"],
-    "window.setSurface": ["window", "setSurface"],
-    "window.setTransaction": ["window", "setTransaction"],
     "window.raise": ["window", "raise"],
     "window.wait": ["window", "wait"]
 });

package/dist/commands/program.js

@@ -196,22 +196,6 @@ export default function programCommands(root, connect) {
         identity: options.program,
         permission: parsePermissionName(options.permission)
     })));
-    defineCommand(programs, {
-        name: "requestPermission",
-        aliases: ["request-permission"],
-        description: executeDescription("program", "requestPermission"),
-        requiresSystem: true,
-        options: withJson(option("--program <identity>", "Program identity", { mandatory: true }), option("--permission <name>", "permission name", { mandatory: true }), option("--value <json>", "complete requested permission value encoded as JSON"), timeoutOption),
-        output: dataOutput(value.any("permission decision"), "The permission decision", { format: "value" }),
-        examples: ["phresh program request-permission --program terminal --permission uploads"]
-    }, ({ options }) => connected(connect, system => system.execute({
-        $domain: "program",
-        $operation: "requestPermission",
-        identity: options.program,
-        permission: parsePermissionName(options.permission),
-        ...(options.value === undefined ? {} : { value: permissionRequest(options.value) }),
-        ...(options.timeout === undefined ? {} : { timeout: bounded(options.timeout, "--timeout", 0) })
-    })));
     defineCommand(programs, {
         name: "logs",
         description: executeDescription("program", "logs"),

package/dist/commands/schemas.js

@@ -3,38 +3,6 @@ import { value } from "../contract/schema.js";
 const metric = {
     anyOf: [value.number("pixels"), value.string("workspace-relative expression")]
 };
-const transaction = {
-    anyOf: [
-        value.boolean("default or disabled transaction"),
-        value.number("duration in milliseconds"),
-        value.object({
-            duration: value.number("duration in milliseconds"),
-            easing: value.any("CSS easing name or cubic Bézier tuple")
-        }, ["duration", "easing"], "appearance transaction")
-    ]
-};
-const surface = {
-    anyOf: [
-        value.boolean("default or absent surface"),
-        value.object({
-            radius: { anyOf: [value.number("radius in pixels"), value.literal("full", "fully rounded radius")] },
-            color: value.string("Appearance color role or CSS color"),
-            material: {
-                anyOf: [
-                    value.literal(false, "disabled Material"),
-                    value.object({
-                        grain: value.number("grain frequency"),
-                        grainAmount: value.number("grain intensity"),
-                        backdrop: value.number("backdrop blur"),
-                        opacity: value.number("Material opacity"),
-                        distortion: value.number("backdrop distortion"),
-                        saturation: value.number("backdrop saturation")
-                    }, [], "partial Appearance Material")
-                ]
-            }
-        }, [], "Window surface customization")
-    ]
-};
 const endpointDeclaration = value.nullable(value.object({
     start: value.boolean("whether a default Process starts this Endpoint"),
     service: value.boolean("default Service role for new execution contexts")
@@ -44,14 +12,12 @@ const clientDeclaration = value.nullable(value.object({
     service: value.boolean("default Service role for new execution contexts"),
     title: value.nullable(value.string("default Window title")),
     header: value.nullable(value.boolean("default Window header visibility")),
-    surface: value.nullable(surface),
-    transaction: value.nullable(transaction),
     size: value.nullable(value.object({ width: metric, height: metric }, ["width", "height"], "default Window size")),
     position: value.nullable(value.object({ x: metric, y: metric }, ["x", "y"], "default Window position")),
     layer: value.nullable(value.enumeration(layers, "default Window layer")),
     minimize: value.nullable(value.boolean("default minimized state")),
     maximize: value.nullable(value.boolean("default maximized state"))
-}, ["start", "service", "title", "header", "surface", "transaction", "size", "position", "layer", "minimize", "maximize"], "resolved Client Endpoint declaration"));
+}, ["start", "service", "title", "header", "size", "position", "layer", "minimize", "maximize"], "resolved Client Endpoint declaration"));
 export const programOutput = value.object({
     identity: value.string("stable Program identity"),
     assetId: value.string("public Program asset identity"),
@@ -89,15 +55,13 @@ export const windowOutput = value.object({
     process: value.string("owning Process identity"),
     title: value.string("Window title"),
     header: value.boolean("whether the Desktop-owned Window header is shown"),
-    surface,
-    transaction,
     position: value.object({ x: metric, y: metric }, ["x", "y"], "Window position"),
     size: value.object({ width: metric, height: metric }, ["width", "height"], "Window size"),
     minimized: value.boolean("whether the Window is minimized"),
     maximized: value.boolean("whether the Window is maximized"),
     front: value.boolean("whether the Window is at the front of its layer"),
     layer: value.enumeration(layers, "Window layer")
-}, ["process", "title", "header", "surface", "transaction", "position", "size", "minimized", "maximized", "front", "layer"], "Window state");
+}, ["process", "title", "header", "position", "size", "minimized", "maximized", "front", "layer"], "Window state");
 export const programPresentation = fields(["Identity", "identity"], ["Asset", "assetId"], ["Name", "name"], ["Version", "version"], ["Description", "description"], ["Installed", "installed"], ["Agent", "hasAgent"], ["Server", "server"], ["Client", "client"]);
 export const programListPresentation = list("data", "Program", "Programs", "No matching Programs", [
     { label: "Name", path: "name" },
@@ -123,7 +87,7 @@ export const serviceListPresentation = list("data", "Service", "Services", "No m
     { label: "Program", path: "program" },
     { label: "Endpoint", path: "endpoint" }
 ]);
-export const windowPresentation = fields(["Process", "process"], ["Title", "title"], ["Header", "header"], ["Surface", "surface"], ["Transaction", "transaction"], ["Position", "position"], ["Size", "size"], ["Minimized", "minimized"], ["Maximized", "maximized"], ["Front", "front"], ["Layer", "layer"]);
+export const windowPresentation = fields(["Process", "process"], ["Title", "title"], ["Header", "header"], ["Position", "position"], ["Size", "size"], ["Minimized", "minimized"], ["Maximized", "maximized"], ["Front", "front"], ["Layer", "layer"]);
 export const windowPositionPresentation = fields(["Process", "process"], ["Position", "position"]);
 export const windowSizePresentation = fields(["Process", "process"], ["Size", "size"]);
 export const windowGeometryPresentation = fields(["Process", "process"], ["Position", "position"], ["Size", "size"]);
@@ -131,8 +95,6 @@ export const windowMinimizePresentation = fields(["Process", "process"], ["Minim
 export const windowMaximizePresentation = fields(["Process", "process"], ["Maximized", "maximized"]);
 export const windowTitlePresentation = fields(["Process", "process"], ["Title", "title"]);
 export const windowHeaderPresentation = fields(["Process", "process"], ["Header", "header"]);
-export const windowSurfacePresentation = fields(["Process", "process"], ["Surface", "surface"]);
-export const windowTransactionPresentation = fields(["Process", "process"], ["Transaction", "transaction"]);
 export const windowRaisePresentation = fields(["Process", "process"], ["Front", "front"]);
 export const eventPresentation = fields(["Scope", "scope"], ["Event", "event"], ["Payload", "payload"]);
 export const lifecyclePresentation = fields(["Scope", "scope"], ["Event", "event"]);

package/dist/commands/system.js

@@ -0,0 +1,32 @@
+import { defineCommand } from "../contract/command.js";
+import { value } from "../contract/schema.js";
+import { connected } from "./connection.js";
+import { executeDescription } from "./execution.js";
+import { json } from "./input.js";
+import { option, withJson } from "./options.js";
+import { dataOutput } from "./schemas.js";
+/** Add running-System capabilities to the System lifecycle command family. */
+export default function systemAccessCommands(root, connect) {
+    const system = root.commands.find(command => command.name() === "system") ?? defineCommand(root, {
+        name: "system",
+        description: "access the running PhreshOS System"
+    });
+    defineCommand(system, {
+        name: "logs",
+        description: executeDescription("system", "logs"),
+        requiresSystem: true,
+        options: withJson(option("--statement <sql>", "read-only SQL statement", { mandatory: true }), option("--values <json>", "bound statement values encoded as a JSON array")),
+        output: dataOutput(value.array(value.any("log query row"), "log query rows"), "System log query result", { format: "value" }),
+        examples: ["phresh system logs --statement 'select createdAt, level, source, kind, content, data from logs order by createdAt desc limit 100' --json"]
+    }, ({ options }) => connected(connect, system => {
+        const parsed = options.values === undefined ? undefined : json(options.values, "--values");
+        if (parsed !== undefined && !Array.isArray(parsed))
+            throw new Error("--values must be a JSON array");
+        return system.execute({
+            $domain: "system",
+            $operation: "logs",
+            statement: options.statement,
+            ...(parsed === undefined ? {} : { values: parsed })
+        });
+    }));
+}

package/dist/commands/window.js

@@ -1,7 +1,7 @@
-import { parseExecuteRequest, parseWindowSurface, parseWindowTransaction } from "@phreshos/core";
+import { parseExecuteRequest } from "@phreshos/core";
 import { defineCommand } from "../contract/command.js";
 import { option, processOptions, timeoutOption, withJson } from "./options.js";
-import { dataOutput, eventOutput, eventPresentation, windowGeometryPresentation, windowSurfacePresentation, windowHeaderPresentation, windowMinimizePresentation, windowMaximizePresentation, windowOutput, windowPositionPresentation, windowTransactionPresentation, windowPresentation, windowRaisePresentation, windowSizePresentation, windowTitlePresentation } from "./schemas.js";
+import { dataOutput, eventOutput, eventPresentation, windowGeometryPresentation, windowHeaderPresentation, windowMinimizePresentation, windowMaximizePresentation, windowOutput, windowPositionPresentation, windowPresentation, windowRaisePresentation, windowSizePresentation, windowTitlePresentation } from "./schemas.js";
 import { connected } from "./connection.js";
 import { bounded, position, size } from "./input.js";
 import { executeDescription } from "./execution.js";
@@ -56,27 +56,6 @@ export default function windowCommands(root, connect) {
         options: withJson(...processOptions, option("--hide", "hide rather than show the Window header")),
         examples: ["phresh window set-header --process main --program terminal --hide", "phresh window set-header --process main --program terminal"]
     }, async ({ options }) => executeWindow(connect, options, { $operation: "setHeader", header: options.hide !== true }));
-    defineCommand(windows, {
-        ...state("setSurface", windowSurfacePresentation),
-        aliases: ["set-surface"],
-        options: withJson(...processOptions, option("--default", "use the default Window surface"), option("--absent", "remove the Window surface"), option("--radius <radius>", "surface radius in pixels or full"), option("--color <color>", "Appearance color role or CSS color"), option("--without-material", "render the surface without Material"), option("--grain <value>", "surface Material grain", { parse: input => numeric(input, "--grain") }), option("--grain-amount <value>", "surface Material grain intensity", { parse: input => numeric(input, "--grain-amount") }), option("--backdrop <value>", "surface Material backdrop blur", { parse: input => numeric(input, "--backdrop") }), option("--opacity <value>", "surface Material opacity", { parse: input => numeric(input, "--opacity") }), option("--distortion <value>", "surface Material distortion", { parse: input => numeric(input, "--distortion") }), option("--saturation <value>", "surface Material saturation", { parse: input => numeric(input, "--saturation") })),
-        examples: [
-            "phresh window set-surface --process overlay --absent",
-            "phresh window set-surface --process overlay --radius full --color primary"
-        ]
-    }, async ({ options }) => executeWindow(connect, options, { $operation: "setSurface", surface: surface(options) }));
-    defineCommand(windows, {
-        ...state("setTransaction", windowTransactionPresentation),
-        aliases: ["set-transaction"],
-        options: withJson(...processOptions, option("--default", "use the default Appearance transaction"), option("--disabled", "disable the default Window transaction"), option("--duration <milliseconds>", "transaction duration", { parse: input => numeric(input, "--duration") }), option("--easing <easing>", "standard easing name or four comma-separated cubic Bézier values")),
-        examples: [
-            "phresh window set-transaction --process overlay --default",
-            "phresh window set-transaction --process overlay --duration 240 --easing ease-out"
-        ]
-    }, async ({ options }) => executeWindow(connect, options, {
-        $operation: "setTransaction",
-        transaction: transaction(options)
-    }));
     defineCommand(windows, {
         ...state("raise", windowRaisePresentation),
         examples: ["phresh window raise --process main --program terminal"]
@@ -87,7 +66,7 @@ export default function windowCommands(root, connect) {
         requiresSystem: true,
         options: withJson(...processOptions, option("--event <event>", "Window event", {
             mandatory: true,
-            choices: ["move", "resize", "minimize", "maximize", "changeTitle", "changeHeader", "changeSurface", "changeTransaction", "front"]
+            choices: ["move", "resize", "minimize", "maximize", "changeTitle", "changeHeader", "front"]
         }), timeoutOption),
         output: dataOutput(eventOutput("The observed Window event"), "One Window event", eventPresentation),
         examples: ["phresh window wait --process main --program terminal --event move --json"]
@@ -115,61 +94,3 @@ async function executeWindow(connect, options, operation) {
     });
     return connected(connect, system => system.execute(request));
 }
-function surface(options) {
-    const materialValues = material(options);
-    const customized = options.radius !== undefined || options.color !== undefined || materialValues !== undefined;
-    const modes = Number(options.default === true) + Number(options.absent === true) + Number(customized);
-    if (modes !== 1)
-        throw new Error("Choose exactly one of --default, --absent, or surface customization options");
-    if (options.default)
-        return true;
-    if (options.absent)
-        return false;
-    return parseWindowSurface({
-        ...(options.radius === undefined ? {} : { radius: options.radius === "full" ? "full" : numeric(options.radius, "--radius") }),
-        ...(options.color === undefined ? {} : { color: options.color }),
-        ...(materialValues === undefined ? {} : { material: materialValues })
-    });
-}
-function material(options) {
-    const values = {
-        grain: options.grain,
-        grainAmount: options.grainAmount,
-        backdrop: options.backdrop,
-        opacity: options.opacity,
-        distortion: options.distortion,
-        saturation: options.saturation
-    };
-    const customized = Object.values(values).some(value => value !== undefined);
-    const modes = Number(options.withoutMaterial === true) + Number(customized);
-    if (modes > 1)
-        throw new Error("Choose only one Material mode");
-    if (options.withoutMaterial)
-        return false;
-    if (!customized)
-        return undefined;
-    return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined));
-}
-function transaction(options) {
-    const customized = options.duration !== undefined || options.easing !== undefined;
-    const modes = Number(options.default === true) + Number(options.disabled === true) + Number(customized);
-    if (modes !== 1)
-        throw new Error("Choose exactly one of --default, --disabled, or --duration");
-    if (options.default)
-        return true;
-    if (options.disabled)
-        return false;
-    if (options.duration === undefined)
-        throw new Error("--easing requires --duration");
-    if (options.easing === undefined)
-        return parseWindowTransaction(options.duration);
-    const pieces = options.easing.split(",").map(value => value.trim());
-    const easing = pieces.length === 4 ? pieces.map(value => numeric(value, "--easing")) : options.easing;
-    return parseWindowTransaction({ duration: options.duration, easing });
-}
-function numeric(value, name) {
-    const result = Number(value);
-    if (!Number.isFinite(result))
-        throw new Error(`${name} must be a finite number`);
-    return result;
-}

package/dist/template/package.json

@@ -1,7 +1,7 @@
 {
     "name": "phresh",
     "private": true,
-    "version": "0.1.42",
+    "version": "0.1.44",
     "description": "The official PhreshOS starter Program.",
     "type": "module",
     "scripts": {
@@ -14,15 +14,15 @@
         "starter"
     ],
     "dependencies": {
-        "@phreshos/client": "^0.1.48",
-        "@phreshos/core": "^0.1.56",
-        "@phreshos/react": "^0.1.29",
-        "@phreshos/server": "^0.1.52",
+        "@phreshos/client": "^0.1.50",
+        "@phreshos/core": "^0.1.59",
+        "@phreshos/react": "^0.1.31",
+        "@phreshos/server": "^0.1.55",
         "react": "^19.2.8",
         "react-dom": "^19.2.8"
     },
     "devDependencies": {
-        "@phreshos/cli": "^0.1.69",
+        "@phreshos/cli": "^0.1.71",
         "@types/node": "^26.4.0",
         "@types/react": "^19.2.18",
         "@types/react-dom": "^19.2.5",

package/dist/template/phresh.config.ts

@@ -4,7 +4,7 @@ export default defineConfig({
     identity: "phresh",
     name: "Phresh Program",
     description: "A minimal counter with direct Client and Server endpoints.",
-    version: "0.1.42",
+    version: "0.1.44",
     icon: "icon.png",
     categories: ["Development"],
     keywords: ["example", "counter", "client", "server"],

package/dist/template/vite.client.ts

@@ -7,7 +7,9 @@ export default defineConfig({
     plugins: [react()],
     base: process.env.PHRESHOS_CLIENT_BASE ?? "./",
     resolve: {
-        tsconfigPaths: true
+        tsconfigPaths: true,
+        // Linked SDKs must consume the Program's renderer instance.
+        dedupe: ["react", "react-dom"]
     },
     server: {
         port: Number(process.env.PHRESHOS_CLIENT_PORT ?? "5200"),

package/dist/template/vitest.config.ts

@@ -1,6 +1,7 @@
 import { defineConfig } from "vitest/config"
 
 export default defineConfig({
+  resolve: { dedupe: ["react", "react-dom"] },
   test: {
     pool: "forks",
     maxWorkers: 2,

package/dist/template.json

@@ -1,6 +1,6 @@
 {
     "repository": "PhreshOS/phresh-program",
-    "version": "0.1.42",
-    "sha256": "a05d624c773f52acaf7b16f65b0fd8f421bf61e7caad84348e4ec3871ae019cd",
+    "version": "0.1.44",
+    "sha256": "5d218afff54104c06bb8e279247f875ccbc68b7ce789b4207da8af3428946c39",
     "development": true
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@phreshos/cli",
   "type": "module",
-    "version": "0.1.69",
+  "version": "0.1.71",
   "description": "The Phresh command-line interface for Program projects and system management.",
   "engines": {
     "node": ">=20.10"
@@ -47,8 +47,8 @@
   "packageManager": "bun@1.3.14",
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-        "@phreshos/core": "^0.1.58",
-        "@phreshos/node": "^0.1.31",
+    "@phreshos/core": "^0.1.60",
+    "@phreshos/node": "^0.1.33",
     "adm-zip": "^0.6.0",
     "commander": "^15.0.0",
     "picocolors": "^1.1.1"