@synopackageland/templates 0.34.0 → 0.35.1

package/README.md

@@ -22,8 +22,8 @@ daemon:
     window_seconds: 300
 ```
 
-Templates 0.34.0 pin UI 0.16.1 and SDK 0.36.0 in native and Compose projects.
-Use CLI 0.38.0. The Vue `AppShell` shows a
+Templates 0.35.1 pin UI 0.16.1 and SDK 0.38.0 in native and Compose projects.
+Use CLI 0.41.1. The Vue `AppShell` shows a
 non-blocking **Reload** notice when an upgrade replaced the UI an open page
 loaded. Go Apps select
 their controller from their Go SDK requirement; an identity gateway selects it
@@ -81,19 +81,19 @@ calls each one from the generated script of the same name (`synopkgland skill sh
 The placeholders `__PACKAGE__` (also the Go module path), `__DISPLAY_NAME__` and
 `__BACKGROUND_ENABLED__` are substituted by `init`.
 
-`backend/go.mod` requires `github.com/synopackageland/syno-pkg-land-sdk v0.32.0`; that line is
+`backend/go.mod` requires `github.com/synopackageland/syno-pkg-land-sdk v0.38.0`; that line is
 the single source of the SDK version and `frontend/package.json` pins
 `@synopackageland/sdk` to the same version. Python and Node.js name it in
 `backend.sdk`, Rust in the `syno-pkg-land-app` tag of `backend/Cargo.toml`
-(and `Cargo.lock`); all of them pin 0.32.0. The Vue frontend pins
-`@synopackageland/ui` 0.16.1. SDK 0.32.0 accepts UI `>=0.10.1 <0.18.0`,
+(and `Cargo.lock`); all of them pin 0.38.0. The Vue frontend pins
+`@synopackageland/ui` 0.16.1. SDK 0.38.0 accepts UI `>=0.10.1 <0.18.0`,
 so no UI peer override is needed. Tests use jsdom 30 for UI floating-layer styles.
 
 Interactive NAS file operations use same-origin browser calls.
 Custom file handlers use the SDK's
-[session transport migration](https://github.com/synopackageland/syno-pkg-land-sdk/blob/v0.36.0/docs/dsm-session-transport.md).
-CLI 0.38.0 reads SDK 0.36.0's release manifest, which names immutable
-executor/v0.32.0 and its executor digests. Its `~0.34.0` templates
+[session transport migration](https://github.com/synopackageland/syno-pkg-land-sdk/blob/v0.38.0/docs/dsm-session-transport.md).
+CLI 0.41.1 reads SDK 0.38.0's release manifest, which names immutable
+executor/v0.32.0 and its executor digests. Its `~0.35.1` templates
 dependency selects this release.
 
 Every App method must appear in the permissions table, including methods whose
@@ -106,9 +106,45 @@ authentication. Other paths retain DSM entry admission. See the CLI's
 UI and i18n text, including the DSM glossary, omit terminal sentence periods.
 Keep punctuation between sentences and intentional loading ellipses.
 
+## Request deadlines and background work
+
+SDK/App 0.38.0 defaults to 300 seconds for cooperative requests and 302 seconds
+for the TS client and generated DSM window. The CLI reads the selected SDK's
+timeout spec; `backend.timeout_seconds` explicitly overrides it for native
+backends, and an earlier parent deadline still wins. Go assembly should fall
+back to `api.DefaultRequestTimeout`, as the scaffold does. Rebuild with matching
+Go/TS SDK versions: installed Apps and explicit manifest budgets do not change
+automatically. Binary/non-SDK fallbacks keep their own limits.
+
+For long NAS work, use the existing jobs capability and independent package-account
+worker or resident daemon. Authenticate a fixed operation and trusted owner,
+admit with `NewRequestStore` / `SubmitSingleton` or `Submit`, and return the
+existing outcome and original job ID promptly. Execute `Runner.Work` separately
+and report phases/progress with `Task.Report`; unknown totals stay unknown.
+Jobs and delegated downloads default to 30 minutes; trusted assembly may select
+a finite allowance suited to the operation.
+
+Authenticate every status/result/cancel read and poll with bounded backoff by
+the original ID. Keep the last known state through read failures. Show
+`queued` / `running` as still working; a slow NAS or timed-out status request
+does not fail a job. Only terminal states establish completion. After a lost
+admission reply, reuse the same idempotency key and input, or query the known
+ID; never replay a dispatched mutation with a new key because a reply was lost.
+Cancellation cannot undo remote effects.
+
+Direct browser File Station reads also default to 302 seconds, and identity
+gateway response headers to 310 seconds. Match customized proxy/header budgets.
+Other DSM versions and external proxies may impose separate limits; these
+defaults are not a universal five-minute end-to-end guarantee. Executor batch
+caps, approved root policy/program budgets and credential lifetimes retain
+their existing limits; long root work uses `root.start` / `root.jobs.*`.
+The independent ctl transport keeps its 62-second default: use an explicit
+`--timeout` for long synchronous calls, or an existing nonblocking job flow.
+See the SDK's [request deadline contract](https://github.com/synopackageland/syno-pkg-land-sdk/blob/v0.38.0/docs/request-deadlines.md).
+
 ## Hyper Backup
 
-Native Apps appear in Hyper Backup as applications by default. CLI 0.38.0
+Native Apps appear in Hyper Backup as applications by default. CLI 0.40.0
 builds them with a fixed `scripts/backup/` shim that Hyper Backup runs as
 root; it only switches to the package account, which archives or restores the
 App's data folder with the SDK backup control. The App itself still runs as
@@ -124,7 +160,7 @@ Keep `base: './'`, relative imports and `cssCodeSplit: false`; allow lazy chunks
 with `() => import('./Page.vue')` or `defineAsyncComponent`. Each mount creates
 its own Vue App and returns synchronous cleanup.
 
-CLI 0.38.0 copies the entire output into `ui/app/<tree-sha256>/` and verifies it
+CLI 0.40.0 copies the entire output into `ui/app/<tree-sha256>/` and verifies it
 during `inspect`. Changing a lazy chunk changes the snapshot URL. An open page
 may need to reload after an upgrade when an old lazy chunk is unavailable.
 See the SDK's [frontend bundle contract](https://github.com/synopackageland/syno-pkg-land-sdk/blob/main/docs/frontend-bundles.md).
@@ -263,4 +299,4 @@ The bridge examples expose submission, lookup and cancellation through
 
 ## External access
 
-With CLI 0.38.0 and SDK 0.36.0, a gateway App may declare `identity_gateway.external_access: {connect: optional, origin_change: confirm, single_origin: true}` for an upstream that signs in on one fixed URL. The policy is forwarded to the packaged gateway. A single-origin App's `manual_origin` accepts an explicit HTTPS port; the `external-origin` installation setting remains restricted to port 443. The DSM launcher selects a provider destination, probes `/_spl/ping` for up to eight seconds, and explains failures before offering **Open anyway**. A configured single-origin App always opens its primary external origin.
+With CLI 0.40.0 and SDK 0.38.0, a gateway App may declare `identity_gateway.external_access: {connect: optional, origin_change: confirm, single_origin: true}` for an upstream that signs in on one fixed URL. The policy is forwarded to the packaged gateway. A single-origin App's `manual_origin` accepts an explicit HTTPS port; the `external-origin` installation setting remains restricted to port 443. The DSM launcher selects a provider destination, probes `/_spl/ping` for up to eight seconds, and explains failures before offering **Open anyway**. A configured single-origin App always opens its primary external origin.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synopackageland/templates",
-  "version": "0.34.0",
+  "version": "0.35.1",
   "description": "Project templates for synopkgland init: native-go, native-python, native-node and native-rust (plain or Vue, with jobs, delegate and root-ops overlays), binary and compose.",
   "license": "MIT",
   "repository": {

package/templates/compose/dsm-package.yaml

@@ -16,7 +16,7 @@ compose:
   web: {service: web, port: 8080, health: {path: /, status: 200}}
   network: {egress: isolated}
 identity_gateway:
-  sdk: 0.36.0
+  sdk: 0.38.0
   mode: none
   listen: {http: 28000}
 # Web Apps default to new-page through the shared app-launch resolver.

package/templates/native-go/README.md

@@ -15,6 +15,20 @@ DSM main menu → DSM window (ui/app.js)
       4. your handler (backend/internal/app)
 ```
 
+## Requests and long work
+
+SDK/App 0.38.0 defaults to 300-second requests and a 302-second browser wait.
+Explicit `backend.timeout_seconds` and earlier parent deadlines still apply;
+rebuild the App to use the new SDK. For long NAS work, enable the existing jobs
+capability: return admission and the original job ID promptly, execute in the
+independent package-account worker and report phase/progress. Authenticate
+status/result polling by that ID; a slow NAS or failed status read leaves the
+last queued/running state intact. After a lost admission reply, reuse the same
+idempotency key and input instead of replaying a mutation with a new key.
+Jobs default to 30 minutes; approved executor limits remain separate. ctl keeps
+its 62-second transport default; use an explicit `--timeout` or an existing
+nonblocking job. See the SDK's [request deadline contract](https://github.com/synopackageland/syno-pkg-land-sdk/blob/v0.38.0/docs/request-deadlines.md).
+
 ## Quick start
 
 Needs Node.js with `synopkgland` installed, and Go 1.25+.

package/templates/native-go/backend/THIRD_PARTY_NOTICES.txt

@@ -1,6 +1,6 @@
 Native Go package build dependencies
 
-github.com/synopackageland/syno-pkg-land-sdk v0.36.0 (MIT)
+github.com/synopackageland/syno-pkg-land-sdk v0.38.0 (MIT)
 
 Copyright (c) 2026 synopkgland
 

package/templates/native-go/backend/go.mod

@@ -4,6 +4,6 @@ go 1.25.0
 
 toolchain go1.26.10
 
-require github.com/synopackageland/syno-pkg-land-sdk v0.36.0
+require github.com/synopackageland/syno-pkg-land-sdk v0.38.0
 
 require golang.org/x/sys v0.44.0 // indirect

package/templates/native-go/backend/go.sum

@@ -1,4 +1,4 @@
-github.com/synopackageland/syno-pkg-land-sdk v0.36.0 h1:fG/QC6tYqM1tKKdVNKkIbkRiH5DALE2Y/NeeBIMBqkU=
-github.com/synopackageland/syno-pkg-land-sdk v0.36.0/go.mod h1:8GwREGbczc8mAk4Gv8FUHaukXXCUstjzkovQrNV59Cc=
+github.com/synopackageland/syno-pkg-land-sdk v0.38.0 h1:rAUTfGs6mcrHRQ+vt/GpU/RV3/eP+bnCq3bLdWvKZVk=
+github.com/synopackageland/syno-pkg-land-sdk v0.38.0/go.mod h1:8GwREGbczc8mAk4Gv8FUHaukXXCUstjzkovQrNV59Cc=
 golang.org/x/sys v0.44.0 h1:ildZl3J4uzeKP07r2F++Op7E9B29JRUy+a27EibtBTQ=
 golang.org/x/sys v0.44.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=

package/templates/native-go-vue/frontend/package-lock.json

@@ -7,7 +7,7 @@
       "name": "native-dsm-vue-app",
       "dependencies": {
         "@lucide/vue": "1.48.0",
-        "@synopackageland/sdk": "0.36.0",
+        "@synopackageland/sdk": "0.38.0",
         "@synopackageland/ui": "0.16.1",
         "vue": "3.5.43"
       },
@@ -1152,9 +1152,9 @@
       }
     },
     "node_modules/@synopackageland/sdk": {
-      "version": "0.36.0",
-      "resolved": "https://registry.npmjs.org/@synopackageland/sdk/-/sdk-0.36.0.tgz",
-      "integrity": "sha512-AELmjma44MpHypbJXLOQcj3gERydKlpBvLW2Rhf9XR5plercH/mgyB54Zu6w7pFVfLgUtz+SPykofatvOQsi8w==",
+      "version": "0.38.0",
+      "resolved": "https://registry.npmjs.org/@synopackageland/sdk/-/sdk-0.38.0.tgz",
+      "integrity": "sha512-7mDRCpxBVT26CZdptzwxgVaNei0/gy1SmfrPECaZNwwZDTppZkizcnmkYNPJugJWBhtlUNOq1i+uUL8U7iW/2w==",
       "license": "MIT",
       "peerDependencies": {
         "@lucide/vue": "^1.48.0",

package/templates/native-go-vue/frontend/package.json

@@ -8,7 +8,7 @@
   },
   "dependencies": {
     "@lucide/vue": "1.48.0",
-    "@synopackageland/sdk": "0.36.0",
+    "@synopackageland/sdk": "0.38.0",
     "@synopackageland/ui": "0.16.1",
     "vue": "3.5.43"
   },

package/templates/native-node/README.md

@@ -15,6 +15,20 @@ DSM main menu → DSM window (ui/app.js)
       4. your method, which may ask the runtime for services (files, jobs, executor)
 ```
 
+## Requests and long work
+
+SDK/App 0.38.0 defaults to 300-second requests and a 302-second browser wait.
+Explicit `backend.timeout_seconds` and earlier parent deadlines still apply;
+rebuild the App to use the new SDK. For long NAS work, enable the existing jobs
+capability: return admission and the original job ID promptly, execute in the
+independent package-account worker and report phase/progress. Authenticate
+status/result polling by that ID; a slow NAS or failed status read leaves the
+last queued/running state intact. After a lost admission reply, reuse the same
+idempotency key and input instead of replaying a mutation with a new key.
+Jobs default to 30 minutes; approved executor limits remain separate. ctl keeps
+its 62-second transport default; use an explicit `--timeout` or an existing
+nonblocking job. See the SDK's [request deadline contract](https://github.com/synopackageland/syno-pkg-land-sdk/blob/v0.38.0/docs/request-deadlines.md).
+
 ## Quick start
 
 Needs Node.js 20 or later with `synopkgland` installed. The SPK depends on DSM's **Node.js v20** package (INFO `install_dep_packages`).

package/templates/native-node/dsm-package.yaml

@@ -49,7 +49,7 @@ backend:
   runtime: node
   dir: backend/app
   entry: main.js
-  sdk: 0.36.0
+  sdk: 0.38.0
   node: { package: Node.js_v22 }
 
 ui:

package/templates/native-python/README.md

@@ -15,6 +15,20 @@ DSM main menu → DSM window (ui/app.js)
       4. your method, which may ask the runtime for services (files, jobs, executor)
 ```
 
+## Requests and long work
+
+SDK/App 0.38.0 defaults to 300-second requests and a 302-second browser wait.
+Explicit `backend.timeout_seconds` and earlier parent deadlines still apply;
+rebuild the App to use the new SDK. For long NAS work, enable the existing jobs
+capability: return admission and the original job ID promptly, execute in the
+independent package-account worker and report phase/progress. Authenticate
+status/result polling by that ID; a slow NAS or failed status read leaves the
+last queued/running state intact. After a lost admission reply, reuse the same
+idempotency key and input instead of replaying a mutation with a new key.
+Jobs default to 30 minutes; approved executor limits remain separate. ctl keeps
+its 62-second transport default; use an explicit `--timeout` or an existing
+nonblocking job. See the SDK's [request deadline contract](https://github.com/synopackageland/syno-pkg-land-sdk/blob/v0.38.0/docs/request-deadlines.md).
+
 ## Quick start
 
 Needs Node.js with `synopkgland` installed, and Python 3.8 or later.

package/templates/native-python/dsm-package.yaml

@@ -47,7 +47,7 @@ backend:
   runtime: python
   dir: backend/app
   entry: main.py
-  sdk: 0.36.0
+  sdk: 0.38.0
 
 ui:
   # Non-UI-SDK frontends open a full page; Portal is a separate opt-in.

package/templates/native-rust/README.md

@@ -15,6 +15,20 @@ DSM main menu → DSM window (ui/app.js)
       4. your method, which may ask the runtime for services (files, jobs, executor)
 ```
 
+## Requests and long work
+
+SDK/App 0.38.0 defaults to 300-second requests and a 302-second browser wait.
+Explicit `backend.timeout_seconds` and earlier parent deadlines still apply;
+rebuild the App to use the new SDK. For long NAS work, enable the existing jobs
+capability: return admission and the original job ID promptly, execute in the
+independent package-account worker and report phase/progress. Authenticate
+status/result polling by that ID; a slow NAS or failed status read leaves the
+last queued/running state intact. After a lost admission reply, reuse the same
+idempotency key and input instead of replaying a mutation with a new key.
+Jobs default to 30 minutes; approved executor limits remain separate. ctl keeps
+its 62-second transport default; use an explicit `--timeout` or an existing
+nonblocking job. See the SDK's [request deadline contract](https://github.com/synopackageland/syno-pkg-land-sdk/blob/v0.38.0/docs/request-deadlines.md).
+
 ## Quick start
 
 Needs Node.js with `synopkgland` installed, Rust through rustup, Zig and `cargo-zigbuild`: `backend/rust-toolchain.toml` pins 1.97.1 with the three DSM targets, so the first `cargo` run installs them.

package/templates/native-rust/backend/Cargo.lock

@@ -104,8 +104,8 @@ dependencies = [
 
 [[package]]
 name = "syno-pkg-land-app"
-version = "0.36.0"
-source = "git+https://github.com/synopackageland/syno-pkg-land-sdk?tag=v0.36.0#255d1f45482871eccee0db225e3795fa45aa8b59"
+version = "0.38.0"
+source = "git+https://github.com/synopackageland/syno-pkg-land-sdk?tag=v0.38.0#a8592da6d2cd0854f78f1e9a1abd36cc9cf2f463"
 dependencies = [
  "libc",
  "serde",

package/templates/native-rust/backend/Cargo.toml

@@ -9,7 +9,7 @@ libc = "0.2"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 # The SDK version is the tag; `synopkgland check` reads it from Cargo.lock.
-syno-pkg-land-app = { git = "https://github.com/synopackageland/syno-pkg-land-sdk", tag = "v0.36.0" }
+syno-pkg-land-app = { git = "https://github.com/synopackageland/syno-pkg-land-sdk", tag = "v0.38.0" }
 
 [profile.release]
 # A handler panic becomes an "internal" reply; abort would end the App without one.